RSTS-11 



SYSTEM USER'S GUIDE 




DEC-11-ORSUA-A-D 

RSTS-11 
SYSTEM USER'S GUIDE 



FOR USE WITH RSTS-n 

Version V004A 
(PDP-11 RESOURCE TIME-SHARING SYSTEM) 



September 1972 

SOFTWARE SUPPORT CATEGORY 

THE SOFTWARE DESCRIBED IN THIS DOCUMENT IS 
SUPPORTED BY DEC UNDER CATEGORY I AS DEFINED 
ON PAGE IV OF THIS DOCUMENT, 



FOR ADDITIONAL COPIES, ORDER NO. DEC-ll-ORSUA"A-D FROM DIGITAL EQUIPMENT 
CORPORATION, SOFTWARE DISTRIBUTION CENTER, MAYNARD, MASSACHUSETTS 01754 



First Printing, September 1972 



Your attention is invited to the last two pages of this document. The Reader's 
Comments page, when completed and returned, is beneficial to both you and 
DEC. All comments received are considered when documenting subsequent 
manuals. The How To Obtain Software Information page offers you a means 
of keeping up to date with DEC's software. 



Copyright © 1972 by Digital Equipment Corporation 



NOTE 

The material in this manual is for information purposes 
and is subject to change without notice. 

DEC assumes no responsibility for the use or reliability 
of its software on equipment which is not supplied by DEC. 



Associated Documents: 



BASIC-PLUS Language Manual 
DEC-11-ORBPA-A-D 



The following are trademarks of Digital Equipment Corporation: 

DEC PDP-11 

DIGITAL (logo) FOCAL- 11 

COMTEX-11 UNIBUS 

DECtape RSTS-11 
RSX-11 



Prefac 



This manual deals with the interaction between the user and the RSTS-11 terminal, how to 
enter and edit user programs, and how to give commands to BASIC-PLUS. 

The operations of listing, running, saving, or compiling a program differ in kind from 
the individual statements composing the program. System commands cause these operations to 
be performed. Other system operations include assigning of peripheral devices for program 
input and/or output, determining the length of the current program or number of user files 
available, renaming and replacing of current files, and enabling and disabling of the echo 
feature on the RSTS-11 terminal. 
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At the option of DEC, a software product may be recategorized from Category I to 
Category II for a particular customer if the software product has been modified by the customer 
or a third party. 



CATEGORY II 
Software Products that Receive Support for a Fee 

This category includes prior versions of Category I programs and all other programs avail- 
able from DEC for which support is given. Programming assistance (additional support), as 
available, will be provided on these DEC programs and non-DEC programs when used in con- 
junction with these DEC programs and equipment supplied by DEC . 



CATEGORY III 
Pre-Release Software 

DEC may elect to release certain software products to customers in order to facilitate 
final testing and/or customer familiarization. In this event, DEC will limit the use of such 
pre-release software to internal, non-competitive applications. Category III software is only 
supported by DEC where this support is consistent with evaluation of the software product. 
While DEC will be grateful for the reporting of any criticism and suggestions pertaining to a 
pre-release, there exists no commitment to respond to these reports. 



CATEGORY IV 
Non - Su ppor ted Software 

This category includes all programs for which no support is given 
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CHAPTER 1 
INTRODUCTION TO RSTS-11 

RSTS-11 (Resource Sharing Timesharing System for the PDP-11 computer) is a powerful 
timesharing system that can support up to 16 interactive terminals. From each terminal a user 
has access to any peripheral device on the system. 

RSTS-11 uses the BASIC-PLUS language, an enriched version of the BASIC language as 
originally developed at Dartmouth College. BASIC-PLUS is compatible with existing BASIC 
programs and includes facilities to handle strings, matrices, and files. 

1.1 TIMESHARING 

Early computers were the province of the mathematician. Used mainly to solve differen- 
tial equations, the systems were narrow in scope and poorly utilized. Since few persons were 
knowledgeable enough to employ the enormous processors, one individual could monopolize 
computer time — sit at the console and solve problems in step-by-step fashion. 

As more people discovered computing techniques, it was no longer practical to let a few 
persons monopolize computer time. To increase machine efficiency, batch processing was 
introduced. In this mode of operation, no time was wasted between jobs. Programs were 
punched on cards and the cards stacked and fed to the computer in batches. Operation of each 
program was governed by control cards that took the place of the human operator. 

Since card reading is a relatively slow process, some early systems employed a small 
computer to read the cards and transfer program information to magnetic tape that was then 
input to the large computer. As a further refinement, programs were assigned priorities, with 
short jobs being executed first to minimize job turnaround. 

But what about the computer user? As computer utilization improved, program develop- 
ment took more time. To develop a new program, a user performed the following procedure. 
After writing the program on paper, he carried it to a keypunch operator to have the cards 
punched and verified. A day or so later, when the program was returned, the user checked 
for punching errors, then returned to the keypunch for corrections. 

Next, he sent the cards to the computer center for compilation. The compilation, which 
might not be returned for a half day or more, could reveal spelling or syntactical errors. The 
cards then had to be changed and resubmitted — another half day's wait. If the next 
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compilation was successful and the program was run, program logic errors might be discovered — new 
cards, new compilation, etc., etc. In addition, the user often studied reams of computer 
listings to find the errors. Using these inefficient methods, even simple programs might take 
weeks to develop. 

Batch processing maximizes machine efficiency in routine data processing operations where 
turnaround is not critical. But for program development and modification, the user requires 
another mode of operation. The user needs a way to "interact" with the computer -- to feed 
his program to the system, line by line, and continuously check the results. 

In fact, the user may want to develop interactive programs. These programs, which are 
extremely productive tools, ask the user questions and perform an analysis based on his answers. 

If the user had unlimited funds, he might be tempted to buy or lease a large computer — a 
system he could dedicate to his work that would provide sufficient power, many peripherals, and 
a large variety of software. With such a system, the user could develop programs interactively 
or utilize batch processing for routine tasks. However, costs normally preclude the dedication 
of a large system to a single user. 

By using timesharing, the user has most of the benefits of a dedicated system at a small 
fraction of the cost. Timesharing with today's technology allows a large powerful computer 
such as a PDP-10 to handle 20, 50, 100 or more users simultaneously. Through a choice of 
terminals, the user can interact with the system or initiate batch processing which runs con- 
currently. The user also has access to a choice of mass storage and peripherals and a selection 
of languages and application programs. Since response is fast, the user appears to have a 
dedicated system. Yet costs are shared. He pays only for the time and facilities that he 
requires and doesn't pay for the time the machine is idle. 

A timesharing system isn't just any computer with some additional hardware and software. 
It's a system designed specifically for timesharing. Otherwise, facilities are limited, fewer 
users can be handled efficiently, and economics are unattractive. 

In a simple timesharing system, each program is assigned a fixed time slice or time 
quantum and operation is switched from one program to another in round robin fashion until 
each program is completed. Essentially, if each user receives 1/60 of a second and 12 users 
are "on" the system, each user will receive service every 1/5 of a second. 

The timesharing system performs multiprogramming; that is, it allows several programs to 
reside in core sirrultaneously and to operate sequentially. The switching between programs is 
initiated by a clock which interrupts the central processor to signal that a certain time period 
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has elapsed. A monitor, also called an operating system or executive program, directs the 
execution of these tasks and performs other duties. 

The system discussed so far services a number of users sequentially in round robin fashion. 
To increase the number of users serviced, more main memory or core is required. However, since 
core is expensive, a secondary memory is employed. This memory — usually magnetic disk or 
drum — Is slower than core or main memory but provides greatly increased capacity at reasonable 
cost. User programs can be located in secondary memory and moved into main memory for 
execution. Programs entering main memory exchange places with a program (or programs) that 
has just been serviced by the central processor. This operation is called swapping. 

In operation, main memory is divided into separate memory blocks. Secondary memory 
is connected to these blocks through a high speed input/output processor — a hardware device 
that allows the disk or drum to swap a program into any one of the main memory blocks without 
any aid from the central processor. This structure allows the central processor to be operating 
a user program in one block of memory while programs are being swapped to and from another 
block. This independent overlapped operation greatly improves efficiency and processing 
power. 

Round robin scheduling, in which each program operates in sequence and receives a fixed 
amount of time, is effective only if all programs have similar requirements. Such is not the 
case, however. At any particular time, a timesharing system will be handling some programs 
which require extensive amounts of computing time (and are said to be compute bound) and 
other programs that must stop frequently for input or output (I/O bound). 

To serve programs at and between these two extremes, the scheduling algorithm must 
provide frequent service to I/O bound programs and must give compute bound jobs longer time 
quantums to prevent wasteful swapping. A simple dynamic scheme could provide two 
queues -- one for each type of job. When a user first logs on to the system, he is placed in 
an I/O bound queue (waiting line) where he receives frequent service and small time quantums. 
If the program isn't completed or does not request input or output during the time allotted to 
him, the job needs more computing time and is placed in the compute bound queue. Thus the 
scheduling algorithm optimizes system efficiency by automatically adjusting to program 
requirements. 

In the present state of scheduling art, algorithms are constantly being changed and im- 
proved. Current algorithms are extremely sophisticated, providing excellent service for most 
timesharing job mixes. They also allow fine tuning, if such modifications are necessary. 
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The ability of the algorithm to match processing to program requirements ensures the best service 
possible for all user programs. 

A timesharing system has performed its basic function if it allows a number of users 
simultaneous access to a central computer. However, to be fully useful, the system should 
also allow the users access to other system resources — storage devices for his programs and data, 
line printers, card readers, etc. For example, the user should be able to choose between 
magnetic tape and disk for program storage. And if he has a 50-page report to produce, he 
should be able to employ a line printer instead of his Teletype. If users controlled these 
devices, however, much confusion might result. For example, two users might select the line 
printer at the same time. If one user was processing Abraham Lincoln's Gettysburgh Address 
and another Mark Anthony's funeral oration, the report might look like the following: 

I COME TO BURY CAESAR NOT TO PRAISE HIM 

FOUR SCORE AND SEVEN YEARS AGO 

THE EVIL THAT MEN DO LIVE AFTER THEM 

OUR FATHERS BROUGHT FORTH ON THIS CONTINENT 

To prevent users from interfering with each other, the monitor coordinates input and output 
(I/O). 

The user can request that a particular device be assigned for his use, and release the 
device upon completion of an operation. During this time no other user can perform I/O to 
an assigned device. If the user does not specifically assign a device but attempts to use it, 
he is given access to the device if it is not already assigned to another user or currently being 
used. 

If a user does not require a fast device for his exclusive use (like a private disk), he can 
elect to use a public device, such as the public disk area, line printer, paper tape devices, 
etc. 

User programs and data can coexist on the same storage device. A filing system is 
necessary if program and data segments are to be retrieved in proper order. 

Data is transferred from memory to a peripheral device as a block of words or a record. 
(A word is the number of binary digits or bits that the central processor can retrieve and 
"operate on" at one time.) Record length can be arbitrary or dictated by the physical device 
being used, for example, the number of columns on an 80 column card or on a 132 column line 
printer. For PDP-11 disk files, the normal length is 256 words. This can be altered with 
the RSTS-11 Record I/O features. 



Teletype is a registered trademark of the Teletype Corporation. 
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For convenience each user's blocks are organized in groups called files. Files, like 
memory, must be protected from access by unauthorized users. When a user creates a file, he 
can restrict it, specifying whether others can have access, and (if access is permitted) whether 
the files can be modified or only read. With such an arrangement, programmers in various 
locations can use the same data to work simultaneously on the same project; but unauthorized 
personnel cannot modify or read the files. 

Users can communicate with the computer over the conventional dial-up telephone net- 
work. User terminals can, therefore, be located anywhere that phone service is available and 
be connected to any computer system, feasibility limited only by long distance phone rates. 

Each user terminal is connected to a data set or modem (modulator-demodulator) which 
converts user terminal output into a signal suitable for the telephone network. At the computer 
end of the phone lines, there is another data set which reconverts the signal and feeds it to the 
central processor. 

The number of data sets employed at the user end of the system is unlimited. At the 
computer end of the communications network, however, the number of data sets is limited by 
the number of users that can be serviced simultaneously by the system. 

In order to gain access to the system, the user dials the system phone number from his 
data set. The telephone network handles the call, scanning the data sets at the computer 
system. If all of the sets are busy, the user receives a busy signal, just as he would with 
normal phone service. If a set is available, the telephone network rings it, and the computer 
answers the call, placing the user in communication with the monitor. The terminal is then 
on-line and ready for operation. 

1.2 USING RSTS-II 

The remainder of this document describes how to use the RSTS-11 system from the user 
terminal. The user may issue commands to the RSTS-11 monitor (Chapter 2) or use any of the 
system programs available in the system library (Chapter 4). Chapter 5 describes the manual 
operation of typical RSTS-11 peripheral devices. 

For information on the BASIC-PLUS language, the user is referred to the BASIC-PLUS 
Language Manual . The appendices to this document summarize the language elements as 
well as other information such as commands and error messages. 
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CHAPTER 2 
RSTS-I1 SYSTEM COMMANDS 

2.1 ON-LINE WITH RSTS-11 

2.1.1 Project-Programmer Numbers and Passwords 

Before the user attempts to use the RSTS-11 system, the system manager will assign him a 
unique project-programmer number and password. The project-programmer number might, for 
example, look as follows: 

The number lj2(0 above is the project number (possibly held by a group of people having a common 
interest) ; and the number ]0] is the programmer number (held by only one person within the 
project group). Thus, each individual's project-programmer number is different. The project- 
programmer number is also called the user's account number. Protection codes are assigned to 
user files on the basis of the various relationships among users as determined by the components 
of their account numbers (see section 2.4.3 describing the NAME-AS statement). 

The user password is a unique alphanumeric code assigned to an individual user. This 
password is never printed on the terminal and, hence, allows for a measure of security in limiting 
the use of the computer system . 

2.1.2 Getting On-Line, HELLO Command 

Equipped with the codes to obtain access to the system, the user should find a terminal and 
turn the LINE-OFF-LOCAL knob to LINE. This puts the Teletype terminal on-line to RSTS-11, 
that is, opens a line of communication between the computer and the terminal. 

Once the terminal is on-line, type the command: 

HELLO 

followed by the RETURN key. This tells RSTS-11 that a user wishes to join the system. RSTS-11 
responds by printing a system identification message, then prints a number sign ( # ) at the left 
margin of the paper, and then waits for the user to type his project-programmer number (followed 
by the RETURN key). The system responds by printing: 

PASSWORD: 

and then waits for the user to type his password followed by the RETURN key. The password 



This knob is found on ASR-33 and ASR-35 Teletypes. Alternate types of user terminals may have 
a different knob or switch designed to put the device on-line. 
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characters are not printed at the console. If the codes are acceptable to the system, the user 
is logged into the system. A message specified by the system manager is then printed. This 
message generally changes from day to day and provides the user with information on any changes 
or additions to the system. 

If the codes entered are incorrect, the message 

INVALID ENTRY - TRY AGAIN 

is printed and the user can try again. 

The entire process of entering the system is shown below (although the RETURN key is typed 
to enter a line to the system, it does not echo on the terminal paper except to perform a carriage 
return/line feed operation). Characters printed by the system are underlined to differentiate 
them from characters typed by the user. 

HKLLCi 

k c, t. c . w-'A-n yj_yill * P1: ' Jr ' p I Kp? is-a.u— -j± ip:p* q* 

VKi_(i>,-F TO 1-.'- l S- 1 1 ! 

l >y() rj_OMilZli. ° Ai lilLh iLLi±f phu 

TUP* 1 -- OI-LH- b.:\» 1I-V AnjT; IMlKNilQPi CCHIEOL. 
?XV>OP -- PAYF.OL L A\iH CH V. ( 'K - F I •: I \i 1 1 \H- • 



■MVt OF 0L1'-- 



Once successfully logged onto the system, the user can type NEW to create a new program, OLD 
to retrieve a program previously saved, or any other RSTS-11 command. 

An alternate way of logging into the system is to enter the project-programmer numbers on 
the same line with the HELLO command, as shown below. This results in the system prompting 
the typing of the password only. 
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HFLLO 1«0» IMP 

I-MS v4A-H SV5TFV «*P13 JO^ 1 .KP.? 15-A. : U-7P 12:29 A-'*; 



VFLC'O^K 'in FH s- 1 1 ! 

DFYO PPOGhAyS On) IHIi. .SY j; TF* Ar<F: 

S DEN 01 -- OPtlFF- FV71Y AVI.) Ii\Sl-FM T01-Y CO'Ml rOL . 
fL'Ff'OP -- PArPOLL A v 1 ; OhFCK-phl.V 'i I sJ C . 



\)FV. Op OLl.i-- 

Another option available when logging into the system is the use of the slash character 
rather than the comma to separate the project and programmer numbers. The slash character 
inhibits the opening message (s) printed by the system. Such messages are installed on the system 
by the system manager and generally contain useful information. However, when logging into 
the same system several times in one day, it is frequently desirable to eliminate the time neces- 
sary to print a message the user has seen previously. 



HFLLO 

F£T£ V^A-11 SYSTFi* #P13 JOB 1 KPP 15-AHC— 7? 1 P: 3P A« 
#100/ 100 
PA? SWOPD: 



'MFV OP OLD-- 



2.1.3 Going Off-Line , BYE Command 

When the user is ready to leave the terminal, he types the command: 

BYE 

followed by the RETURN key. This tells RSTS-11 that the user has requested to be dismissed 
from the system. At this point RSTS-11 prints 

CONFIRM: 

and waits for the user to give one of the following replies: 
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CONFIRM: 
Reply 

N 



RETURN Key 



Y 



Meaning 

No. The logout sequence is terminated, the user is not 
logged out, and the system again replies NEW OR OLD — 

Individual. The user wishes to individually examine each 
of his files. The system prints a listing of each user file 
on the system disk, its size, protection code and creation 
date, followed by a ? character. The user can reply by 
typing K to kill (delete) the file or type the RETURN 
key to retain the file. (Any reply other than K causes 
the file to be retained.) 

Causes the system to print a message explaining that typing 
a ? character explains acceptable replies. 

Causes the system to print an explanation of the possible 
CONFIRM: replies. 

Yes. The system attempts to proceed with the logout se- 
quence, checking to see that the user has not exceeded the 
disk quota for his project-programmer number. If the user 
has used more than his share of disk storage, an appropriate 
message is printed and he is not allowed to leave the system 
until he is within his disk quota. 



The following is the simplest case in which the user simply logs out of the system. 



EYE 

COMF1 Ft*: t 

SAVED ALL DISK FILFSi 387 FLOCKS P\) [ 

JOB 1 HSFP 100,15)1 LOGGED OFF KPP A 'I 

SYSTEf FS'IS V4A-11 SYSiEi* *P13 

FUAi TIME V.- AS .7 SECONDS 

ELAFSFD TIME WAS '^ SECONDS 

GOOD f.'OFNIMG 



i£F, 11. 
lb-AUG- 



FPFE 
?& 1P:P* Atf 



The following example demonstrates the ? and N replies: 



BYF 

CON F ltt.1 

OPTIOMS 

9 


I 


OTHEF 
CONFIhM 



: ? 

FOR 'CO'MF IH-yi: * APE: 
1HI S HELP MESSAGE 
DOM "1 LOG ME OUT 
INDIVIDUAL FILF DELETION 
K TO DELETE 
<CR> TO SAVE 
LOG ME OUT 



MEV. OF: OLD- 
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The following example shows the sequence in which the user is over his disk quota; deletes 
some files, and then logs dut of the system: 



PYE 

COMF1 Ptf: Y 

DISK QUOTA OK 500 EXCEEDED PY 6* BLOCKS 

SOMK FILECS) MUST BE DELE 'I ED BFFOPF LCCSGIMC 0'«T 

CONS FIR*: I 

;\iOi\JA>"E.PAS 1 60 14-AfJ(-72 ? K 

TPASH . 5 "S3 60 14-AHOVP ? K 

F--TI • 10 6« 1S-AT1C--7? ? 

COM F I Ffi* : Y 

SAVED ALL DISK FILES; 10 RLOCK5 I'» USE, 490 EKEF 

JOB 1 USEP 100* 10? LOC-CFP OFF KPP AT 15-AUC--7P IPs 31 AM 

SYSTE* PSTS V4A-11 SYSTEM #P13 

R( IN! T I (*s F V.. A S 1.7 S F" COM D S 

ELAPSED TIMF VAS ? fclAKJlFSf 4"5 SECONDS 

Hlfin MOPMING 



Upon logging the user out of the system, RSTS-11 deletes, from the disk, any temporary 
files which have been created by the system for the user. Any files created by the user and 
still remaining open on disk (or any I/O device) are closed and saved for future reference. 

Before leaving the terminal, the user.should turn the LINE-OFF-LOCAL knob to OFF. 
(Turning the knob to LOCAL means that the Teletype terminal has power, but is not connected 
to the system. ItlJien operates as a typewriter.) 

2.1.4 Commands That Can Be Given Without Logging into the System 

As long as the RSTS-11 system is in operation, anyone can turn a terminal on-line and 
give one of the commands described in Table 2-1. 

Any of the commands in Table 2-1 can be issued from a terminal prior to logging into the 
system, although the full capabilities of the system program may only be available to a user 
already logged into the system. For details, see the appropriate section on the individual 
system program. 



'Again, instructions refer to the ASR-33 and ASR-35 Teletype terminal. Any other terminal 
being used should be turned off-line and powered down when not in use. 
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Table 2-1 
Logged-Out RSTS-11 Commands 



Command 


Function 


HELP 


Causes a text file to be output to the user terminal explain- 




ing how to log into the system and various system features. 


SYS 


Causes the system to output a system status report to the user 




terminal, using the SYSTAT system program. See section 4.3. 


SET xxxx 


Allows the user to set the characteristics of the user terminal, 




using the TTYSET system program, xxxx is one of the accep- 




table TTYSET arguments, see section 4.5. 


HELLO 


Allows the user to enter the system. Requires the knowledge 




of a legal account number set and the associated password. 




Causes the LOGIN system program to be run, see section 4. 1 . 



2.2 CREATING A BASIC-PLUS PROGRAM 



2.2.1 NEW Command 



In order to create a new user program, the user issues the NEW command: 
NEW 
followed by the RETURN key. The system responds by printing: 
NEW FILE NAME -- 

to which the user responds by typing the name of the new program. No filename extension is 
required (or accepted) at this point. The SAVE and COMPILE commands automatically append 
the correct filename extension. 

Alternatively, the user can give the NEW command followed by the program name, to 
avoid having the system prompt typing of the program name. The command: 

NEW PROG 

is equivalent to the sequence: 



NEW 

NEW FILE NAME 



PROG 
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When the NEW command sequence is entered to the system, it: 

a. Deletes any program currently in memory, and 

b. Causes RSTS-11 to store the new program name. 

The command of the form: 

NEW DT0:BOGLE 

is meaningless. New programs are input from the user terminal only. The OLD command is used 
to input programs from other devices. No system check is made of an existing file of the name 
given in the NEW command. All checking for duplicate file names occurs when the SAVE com- 
mand is given. 

The user has the option of typing the RETURN key instead of indicating a filename. This 
causes RSTS-11 to create a file called NONAME which can be saved or compiled and referenced 
later as NONAME. BAS or NONAME. BAC. This name can be changed at any time (see sec- 
tions 2.2.3 and 2.4.3). The creation of the file NONAME is shown below (the RETURN key, 
although typed, does not echo): 

NEW 

NEW FILE NAME ~ 

READY 

If the SAVE command is issued at this point, it will create the file NONAME. BAS. 

2.2.2 Input of the New Program 

Once the NEW command has been given and a new file created in memory, the user has 
the option of typing the program into the system or entering the program from a pre-punched 
paper tape through the terminal low-speed reader. ' 

If the user is typing his program into the system, he will likely want to use the RSTS-11 
editing features (section 2.2.3) and the LIST and DELETE commands (sections 2.2.4 and 2.2.5). 
Information on how to use the low-speed terminal reader is found in sections 2.6. 1 and 5. 1.4. 



'The ASR-33 Teletype terminal has a low-speed punched paper tape reader. RSTS-11 considers 
input from the Teletype paper tape reader equivalent to input from the terminal keyboard. 
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2.2.3 Editing BASIC-PLUS Programs 

While typing a program at the terminal, or after a source program is brought into memory 
or run, changes can be made in the source program text. These changes are made in what is 
called the editing phase of BASIC, between the time when the system prints READY and the time 
when the user types RUN. (During this phase, system commands and immediate mode statements 
can be executed.) 

The simplest type of correction is done during the typing of a line, before the line is 
entered to the system with the RETURN key. For example: 

10 DEF FUN(X) 

If the user realizes that he has typed FUN instead of FNU, he can type the RUBOUT key once 
for each character to be erased. The RUBOUT key causes the erased character to be echoed on 
the user terminal between backslashes as they are erased. For example: 

10 DEF FUN(X<Rubout ><Rubout xRubout ><Rubout> NU (X)=X+ 2*X/2 + X/2 
Typing the above is printed on the terminal as follows: 

10 DEF FUN(X\X(NU\NU(X)=X+ 2*X/2 + X/2 
If the RETURN key is typed at the end of the above line, the system would receive it as follows: 

10 DEF FNU(X)=X+2*X/2 + X/2 

Frequently it is easier to delete the entire line, rather than type the RUBOUT key several times. 
If the user has not yet entered the line to RSTS-11 with the RETURN key, he can type CTRL/U 
(see section 3.6 ), which erases the entire current physical line. If the RETURN key has been 
typed, the line can be retyped, and the second version will replace the first in the computer 
memory. For example: 

20 LET X = 44.2 : A = 20.01 : B = "ABC" 
20 LET X = 45.2 : A = 20.01 : B = "ABC" 

If these two lines are typed in succession, only the second line is retained by the system. 
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2.2.4 LIST Command 



The LIST command is used to obtain a clean printed copy of all or part of the user's current 
program at the user terminal. This is especially useful during and after an editing session in 
which the original program is changed. 

In order to obtain a printed copy of the entire program as it currently exists within the 
system, type: 

LIST 

When listing the whole program, source lines are printed in line number sequence regard- 
less of the order in which the lines were entered. In order to list a single line, type LIST follow- 
ed by the line number. 

LIST 100 

obtains a printed copy of line 1,0,0. 

In order to list a section of the program, type LIST followed by two line numbers separated 
by a dash. 

LIST W ~ 20 

lists all program lines from line number 1J2J0 to line number 200, inclusive. If 1,00 and/or 2,00 
do not exist in the program, any lines within the range 1,00 to 200 are listed. 

One or more single lines or program sections can be specified in a single LIST command 
by separating the individual elements with commas. For example: 

LIST 25, 30, 50-75, 95, \00-\50 

causes single lines 25, Z0, and 95 to be printed along with the program lines between 50 and 75 
and between 1,00 and 15,0 . Lines or program sections need not be indicated in sequential order 
in the LIST command, but the printed lines appear in the order requested. 



In each of the previous examples, BASIC prints a program header containing the program name 
and the current system date and time. If this header material is not desired (as it might not be 
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during normal editing), the command may be given as LISTNH to delete the header material. To 
summarize: 

LIST Command Meaning 

List List the entire user program as it currently exists. 

USTNH Same as L,ST ' but w!tnout the P ro 9 ram header. 

LISTn List linen. 

LISTNH n List '' ne n without the program header. 

LIST nl-n2 List lines nl through n2, inclusive 

LISTNH nl-n2 List lines nl through n2, inclusive, without the program header. 

Extensive examples of program listings are shown in the BASIC-PLUS Language Manual. 

In listing a program, the ? character is printed at the left of each line which RSTS-1 1 
considers to be in error. For example: 

LISTNH 

10 LET A ,B =25 

?20 PPRINT A+B 

The LIST command sends output to the user terminal only. If a line printer is available on 
the system, 

SAVE LP: 
is the fastest way to obtain a complete program listing. (See Section 2.4. 1.) 
2.2.5 DELETE Command 



The DELETE command is used to remove one or more lines from the current user program. 
For example: 

DELETE 100 

causes line number 100 to be deleted. 

DELETE ]00 - 200 

causes all program lines between and including line numbers 1J3J0 and 200 to be deleted. If \00 
and/or 200 do not exist in the program, any lines within the range from \00 to 20 are deleted. 
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If several lines or groups of lines are to be deleted, the user can separate the individual 
elements with commas, as follows: 

DELETE 100-200, 25.% 30,0-40,0, 470, 1)300-1100, 475 

which deletes all lines between 100 and 200, line 255, lines 300 to 4)30, lines 470 and 475, 
and lines 1000 to 1100. Lines or program segments to be deleted need not be listed in sequential 
order in the DELETE command. 

If only one line is to be deleted, it may be more convenient merely to type the line number 
and the RETURN key as follows: 

10 

which is equivalent to: 

DELETE 10 

Before deleting any line, the user should be certain that no other line references the de- 
leted line (such as a GOTO statement), unless the deleted line is to be replaced. A reference 
to a missing line number will generate an error message when the program is run, halting execution. 

2.2.6 RENAME Command 

The RENAME command causes the name of the program currently in core to be changed to 
the specified name. For example: 

RENAME NEWNAM 

The old name of the program currently in memory is discarded. The current program is now known 
as NEWNAM. If the SAVE command is given at this point: 

SAVE 

the file NEWNAM. BAS is stored on the system disk. 
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2.2.7 Debugging BASIC-PLUS Programs 

The phase of program development during which the user is testing the program is called 
the debuggin , ->hase. Rather than repeatedly executing the program with minor alterations on 
each cycle, debugging can be facilitated by placing STOP statements at strategic places 
throughout the program. When the program is executed, each STOP statement causes a program 
halt, and the message: 

STOP AT LINE 50 

is printed. In the above case, the STOP statement was located at line 50. The user at a RSTS-11 
terminal can then use immediate mode instructions to examine and/or change data values. 

Issuing the CONT command causes program execution to continue at the next statement 
following the last STOP statement executed. 

Once a program is successfully debugged, the extraneous STOP statements can be removed 
with the DELETE command. 

Typing CTRL/C (see Section 3.5) also causes program execution to halt, but there is less 
control over where the program halts. The system prints READY and the CONT command can be 
issued. In this case the program may or may not be able to continue depending upon the program 
status when the CTRL/C was entered. 

When debugging a program with considerable amounts of terminal output, CTRL/O can be 
used as a switch to stop and restart such output (see Section 3.7). 

2.2.8 CONT Command 

As explained in Section 2.2.7, the STOP statement and CTRL/C can be used to cause execu- 
tion halts in a user program. Immediate mode examination of values or changes can then be per- 
formed, and the program restarted at the statement following the last executed statement 
by giving the 

CONT 

command, followed by the RETURN key. When the CONT command is entered, the system 
attempts to continue program execution whenever possible. (This is also true of program halts 
due to execution errors. Following the printing of some error messages, the CONT command may 
cause program execution to be resumed.) If it is not possible to continue program execution for 
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any reason (e.g. the user has modified the memory through immediate mode statements after 
stopping), the 

CAN'T CONTINUE 

message is printed. 

2.3 EXECUTING A BASIC-PLUS PROGRAM 



2.3.1 RUN Command 

The RUN command is used to cause the execution of any source or compiled BASIC-PLUS 
program under RSTS-11. (Source programs are stored as typed by the user; compiled programs 
are described in Section 2.3.3.) 

In order to run the program currently in memory, the user simply types: 

RUN 

This causes the execution of the program. A program header is printed after the RUN 
command is given, consisting of the program name and the current system date and time. 
If this information is not desired, the command: 

RUNNH 

should be given. RUNNH executes the current program without printing the header material. 

Where it is desired to run a program not currently in memory, the command: 

RUN FILEV3 

can be given. This command causes RSTS-11 to search for the file FILEV3.BAC or FILEV3.BAS 
on the system disk; load, compile (if necessary), and run it (if the file is found). 

If FILEV3.BAS (source) and FILEV3.BAC (compiled) both exist, RSTS-11 loads and 
executes FILEV3.BAC since it requires less time. In order to retrieve and execute FILEV3.BAS, 
it is necessary to issue separate OLD and RUN commands or a RUN FILEV3.BAS command. The 
file is then available for any editing to be performed. 
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If FILEV3.BAS exists but FILEV3.BAC does not, then the command 

RUN FILEV3 

loads, compiles and executes FILEV3.BAS. 

Where the file to be run is not present on the system disk, but is stored on another device, 
the format: 

RUN dev:FILNAM 

is used where dev: is the designation of the storage device. For example: 
RUN DTI: TRANS 

which runs the file TRANS. BAS if found on DECtape unit 1. The statement: 
RUN PR: 

reads a BASIC program from the high speed reader and runs it. Since PR: is an input-only 
(non-file structured) device, no filename need be specified. 

if a filename is specified, that filename is used as the current program name when the 
program is read into memory. However, if no filename is specified, the file in memory will 
have no name and no SAVE command, or any other command referencing a filename, can be 
issued without assigning a name to that file (see the RENAME command, Section 2.2.6). The 
same results occur when issuing the command: 

RUN CR: 



NOTE 

The card reader can detect the absence of cards 
in the card reader; however, the paper tape reader 
is unable to distinguish between the absence of 
tape in the reader and the reader being off-line. 
In both cases an: 

END OF FILE ON DEVICE 

error is printed, following which a file with no 
name and containing no statements exists in the 
user's memory. 
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2.3.2 Program Segmenting, CHAIN Statement 

If a user program is too large to be loaded into core and run in one operation, the user 
can segment the program into two or more separate programs. Each program is assigned a distinct 
name; control can be transferred from one program to another with the CHAIN statement used 
as part of a program or in immediate mode. 

The immediate mode form of the CHAIN statement is: 

CHAIN < string>{<line numbei»} 

in which <string> is the filename specification of the next program segment and <line 
number> specifies the line number in the new program segment at which to begin execution. 
If no line number is specified, execution begins with the lowest numbered line. For example: 

CHAIN "PHASE2" 20 

causes the program file PHASE2 to be executed. Execution begins with line 20 in the file 
PHASE2. The CHAIN command first searches for the file PHASE2.BAC and if that search fails, 
will search for PHASE2.BAS. An extension, device specification and/or project-programmer 
number can be included in the filename specification string. 

Communication between various program segments can be achieved by means of the user's 
file area (see the discussion of virtual array files in the BASIC-PLUS Language Manual.) 

When the CHAIN statement is executed, all currently open files are closed, the new 
program is loaded, and execution continues. The CHAIN command is similar to the RUN 
command with the additional capability of specifying a starting line number. 

2.3.3 COMPILE Command 

Normally, RSTS-11 accepts each line of the user program as it is entered and, if the line 
is syntactically correct, translates the line into a form understood by the RSTS-11 Run Time 
System. (The BASIC-PLUS Compiler produces an intermediate code which is then interpreted by 
the RSTS-11 Run Time System into a form executable on the PDP-11 computer.) As the program 
is edited, only those lines which are changed are recompiled (i.e., translated). When the 
SAVE command is given, only the source version of the program (i.e., text that is typed in 
response to the LIST command) is stored in the .BAS file created. In response to the OLD 
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command, BASIC reads the text from the saved file and compiles it in the same manner as when 
the program is entered from the user keyboard. 

Once a program is completely developed and debugged, it may be desirable to avoid the 
time-consuming practice of compiling the program every time it is brought into memory. For 
this reason, the COMPILE command has been provided. COMPILE permits the user to save an 
image of his compiled program, rather than (or in addition to) the source text of the program. 
This compiled version of the program is stored with the filename extension .BAC and can be 
read from the system device and executed with a minimum of overhead. (See Section 2.3.1 .) 

NOTE 

Compiled files have a minimum size requirement 
of 11 blocks. This size may be greater than 
necessary to actually store the compiled (or 
even source) version of a short program. In such 
cases the user should be aware that he is trading 
disk space for execution speed. 

Due to the transformation that takes place when a program is compiled, a file with the 
extension .BAC can only be executed; it cannot be edited. Therefore, the user can issue the 
RUN command with respect to compiled files, but the file cannot be retrieved with the OLD 
command. 

If the current filename (i.e., that which is typed as part of the header listing) is FILEJZfl, 
then the command: 

COMPILE 

saves the compiled program in a file named FILEjZfl.BAC on the system disk. If another name is 
desired for the compiled file, it can be specified. For example: 

COMPILE PROG 

generates a file PROG. BAC on the system disk. Compiled programs are output only to the 
system disk. ' The COMPILE command causes the filename extension .BAC to be appended to 
the current or specified filename for storage in the user's disk library. Compiled files are 



A privileged user can obtain a copy of a compiled file on another device, using the PIP 
system program. 
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stored with a default protection of <60> . To obtain any other protection code, that code 
must be explicitly specified. For example: 

COMPILE <40> 

creates a file on the system disk having the current filename, a .BAC extension, and a protection 
code of <4J#> . At any time protection codes can be altered with the NAME-AS command or 
the PIP system program. 

2.4 PROGRAM FILE MANIPULATION 

2.4.1 SAVE Command 



The SAVE command is used to store BASIC-PLUS source programs on the disk as follows: 

SAVE 
The program currently in memory is saved on the system disk under its current filename with the 
extension .BAS. If a file of the same name exists, the system returns the error message: 

FILE EXISTS-USE REPLACE 
This message is designed to protect the user against inadvertently destroying an existing file. 

Where the current filename is not the desired name, the format: 

SAVE FILNAM 
can be used, which saves the program currently in memory on the system disk under the name 
FILNAM. BAS. The name of the current source program is not stored in memory with any exten- 
sion (no extension is printed as part of the current filename when a LIST command is given). 
The SAVE command appends the .BAS extension when writing the file to a storage device. 

In cases where the desired storage device is not the system disk, the format: 

SAVE dev: 
or: 

SAVE dev:FILNAM 
is used where dev: indicates a device designation. The file is stored as the current filename or 
as FILNAM. BAS on the indicated device. For example: 

SAVE DTJ&ROPE 

saves a copy of the program in memory as the file ROPE. BAS on DECtape unit JZf. 

The SAVE command is usable only when a source file is currently in memory. When a 
program is saved, it is still in the computer memory and can be run, changed, or deleted. 

To obtain a listing of the current source program on the line printer, the user can type: 

SAVE LP: 
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To punch a tape of the current source program on the high-speed paper tape punch, the user 
can type: 

SAVE PP: 

No filename specification is needed with an output-only (non-file structured) device. 

To punch a tape on the low-speed punch, give a LISTNH command, turning the punch on- 
line before typing the RETURN key. This is not recommended as the word READY U punched at 
the end of the tape. Tapes punched on the low-speed punch should be read only through the 
low-speed reader. 

2.4.2 Recalling a Saved Program, OLD Command 

To retrieve the source file of a previously saved BASIC-PLUS program, the OLD command 
is issued as follows: 

OLD 

to which the system replies: 

OLD FILE NAME - - 

The user then types the name of the saved BASIC -PLUS file containing the program. Alternative- 
ly, the user can indicate the old filename without prompting, as follows: 

OLD TAXES 

which calls the saved file TAXES. BAS from the system disk. If the file is not available on the 
disk or if it is protected against the user, an appropriate message is printed. 

Where no filename is indicated, RSTS-11 looks for the file NONAME (which could have 
been created by the user or the system, see Section 2.2. 1). For example: 

OLD 

OLD FILE NAME - - 

READY 

Whatever was stored in the file NONAME. BAS for the current user on the system disk is now 
in memory and available to the user. 
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The OLD command can only retrieve BASIC-PLUS source programs (.BAS files), since 
compiled programs (.BAC files) can be run but not changed. Any program called with the OLD 
command can be edited by the user at the terminal. 

2.4.3 File Protection and Renaming, NAME-AS Statement 

The NAME-AS statement can be used in immediate mode to rename and/or assign protec- 
tion codes to a disk or DECtape file and can be used on a file only by someone logged into the 
system under the account number which owns the file. The format of the command is as 
follows: 

NAME <string> AS <string> 

The specified file, the first <stving> indicated, is renamed as the second <string> indicated. 

Where the file resides on a device other than the default device (system disk), the device 
must be specified in the first string and may optionally be specified in the second string. No 
filename extension assumptions are made by NAME-AS; the filename extension must be specified 
in both strings if any extension is present in the filename. For example: 

NAME "DTje(:OLD.BAS" AS "NEW. BAS" 
is equivalent to: 

NAME "DT0:OLD.BAS" AS "DT0:NEW.BAS" 
but the statement: 

NAME "FILE1.BAS" AS "FILE2" 

is not advised since FILE2 has no extension and could not subsequently be called into core 
via the OLD or RUN commands (which require filename extensions). 

A file protection code can be specified within typed angle brackets as part of the second 
string although it is not required. If a new file protection code is specified, it is reflected in 
the protection assigned to the renamed file. If no new protection code is specified, the old 
protection code is retained. See the BASIC-PLUS Language Manual for a complete description 
of protection codes. 
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NAME "FILE. EXT" AS "FILE. EXT <40>" 

changes only the protection code of the file FILE. EXT stored on the system disk. 

NAME "DT0:ABC.BAS" AS "XYZ.BAS" 

changes the name of the file ABC.BAS on DECtape unit 0. Since no transfer of the file from 
one device to another can be performed with the NAME-AS statement, it is not necessary to 
mention D10: twice; that is, the device of the new filename need not be specified. (To 
transfer a file between devices use the PIP system program.) 

NAME "NEW" AS "NEW.l" 

changes only the extension of the disk file NEW (with no extension) to NEW.l. 

2.4.4 System Library Files 

The system library is conventionally stored under account [l,2] on a RSTS-11 
system. The CATALOGS command can provide each user with a list of those programs 
available in the system library and their protection codes. Rather than specify the [l,2] 
account number as part of the file specification each time a system library program is refer- 
enced, the user may precede a system library filename with the $ character, which is 
synonomous with [1/2 J. 

Most system library files are completely write-protected . Unless the file is also read pro- 
tected, the user can issue OLD or RUN commands with respect to system library files, 
remembering that the OLD command can only be used on a source file. For example: 

OLD$ SYSTAT 



or 



OLD $SYSTAT 
(Spaces are not significant in RSTS-11 command strings.) 
is equivalent to: 

OLD [1,2] SYSTAT. BAS 
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and is only legal where SYSTAT is stored as an available source file in the system library. The 
command: 

RUN$ SYSTAT 

will cause the file SYSTAT. BAC to be loaded and executed, if found; and, if SYSTAT. BAC 
does not exist, the file SYSTAT. BAS is loaded, compiled and executed. (Most system library 
files are .BAC files.) 

2.4.5 Removing a Saved Program, UNSAVE Command 

The UNSAVE command is used to remove a file from a storage device. The form: 

UNSAVE FILNAM.BAC 

removes the file FILNAM. BAC from the disk. (The system disk is the default device.) If the 
command is given: 

UNSAVE FILNAM 

BASIC attempts to remove the file FILNAM. BAS. Unless a filename extension is specified in 
the command, an extension of .BAS is assumed. 

To indicate an alternate storage device, the form: 

UNSAVE dev:filename. extension 

is used where dev: is the device designation. For example: 

UNSAVE DTI: FLAM 

removes the file FLAM. BAS from DECtape unit 1 if it is found. 

2.4.6 Updating a Saved Program, REPLACE Command 

The REPLACE command is used when the user wishes the program in memory to replace a 
file on the system disk with the same name. The command is of the form: 

REPLACE 
or 

REPLACE FILNAM 
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REPLACE performs the same function as SAVE, but destroys the old copy of the same file, if it 
exists, without notifying the user. REPLACE appends a .BAS filename extension to the filename 
already associated with the file or specified in the REPLACE command. Where a filename spec- 
ification is given, REPLACE replaces the file on the system disk with the name indicated. In 
this case the name of the current program, as stored in memory, is ignored. 

2.5 SYSTEM STATUS REPORTS 



2.5.1 LENGTH Command 

The LENGTH command returns the length of the user's current program. The user need 
only type: 

LENGTH 

and enter the command to the system with the RETURN key. For example: 

LENGTH 

2K OF CORE USED 

A minimum 2K of memory (IK = 1024 words) is reserved for each user, with a maximum of 8K 
per user in 28K systems and 6K per user in 24K systems. The size of the current program is 
reported to the nearest IK. 

2.5.2 CATALOG Command 



The CATALOG or CAT command causes a listing of the current user's disk file directory 

to be printed on the requesting user terminal. 

For example: 

CAT 

TTYTST.BAS 4 60 26-JUL-72 26-JUL-72 02:12 PM 

JUNKY1.TST 1 60 26-JUL-72 26-JUL-72 04:06 PM 

TEMP02.TMP 1 60 31-JUL-72 31-JUL-72 02:54 PM 

PROG .BAS 1 60 31-JUL-72 31-JUL-72 02:54 PM 

PROG1 .BAS 1 60 31-JUL-72 31-JUL-72 02:59 PM 

PAT .BAS 1 60 31-JUL-72 31-JUL-72 03:01 PM 

I I t t , I I I 

name extension size in 256- protection last access date creation date creation time 

word blocks code 
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To obtain a catalog of files stored under another user's account number, the command is 
given as: 

CATALOG [ljej0,ljZfl ] 
which lists the system disk files owned by user account [ 1,00, ]fj) J 

CATALOGS 
lists all files in the system library ($ indicates account [l,2 ], the system library). 

To obtain a catalog of files on a device other than the system disk, give the command: 

CATALOG dev: 

where dev: is a device specification (a user account specification can be included in such a 
command). For example: 

CATALOG DTI: 
lists all files on DECtape unit 1 (no account numbers are associated with DECtape files). 

CATALOG MT1: [200,220] 
lists all files stored under account [2,00,2203 on magtape unit 1 . 

2.6 USING RSTS-I1 INPUT/OUTPUT DEVICES 
2 - 6 -l Disable Terminal Echo, TAPE Command 

The TAPE command is used to disable the terminal echo feature when reading a paper tape 
with the low-speed (terminal) reader. The command is given as follows: 

TAPE 

followed by the RETURN key. The tape is then inserted in the low-speed reader and the reader 
control switch is set to START. 
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Prior to giving the TAPE command, the user must set up conditions such that the system 
expects the tape input (generally a BASIC-PLUS program, although a data file could also be 
input this way). For example, giving the following commands: 

NEW PROG 
TAPE 

Causes the system to await a source program file to be entered to the system via the terminal 
tape reader. The terminal echo feature is disabled, so the program is not listed on the terminal 
as it is read. This allows input to proceed more quickly than typing: 

NEW PROG 

and then reading the tape through the low-speed reader. A program listing can be obtained on 
a line printer or on the terminal at a later time, if necessary. 

In tape mode the RETURN and RUBOUT key characters are ignored. 

2.6.2 Enable Terminal Echo, KEY Command 

Since no characters input from the terminal keyboard or reader are echoed following the 
TAPE command, the KEY command is supplied to again enable the terminal echo feature. The 
user is advised to type the LINE FEED key before issuing the KEY command in case the last line 
input was not terminated with a carriage return/line feed pair. The command is typed as: 

KEY 

and entered to the system with the LINE FEED or ESCAPE key'. (Carriage return characters are 
ignored when the terminal is in tape mode.) Following successful entry of the KEY command, 
characters are again echo-printed at the user terminal . 



ESCAPE is shown as ALT MODE on some terminals. 
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2.6.3 Seize Device, ASSIGN Command 

The ASSIGN command is used to reserve an I/O device for the use of a si ngle programmer 
(job number). The command is given in the form: 

ASSIGN dev: 

where dev: is the device specification (see Table 2-2). If the device is present on the system 
and available for use, the system returns the message: 



READY 



If the device is not available for use, the message 

DEVICE NOT AVAILABLE 

is returned. For example: 

ASSIGN LP: 

READY 

ASSIGN PR: 

DEVICE NOT AVAILABLE 

If more than one job is logged into the system under a single account number, only the user 
(job number) performing an ASSIGN (or DEASSIGN) is affected by that command. 

TABLE 2-2 
DEVICE SPECIFICATIONS 



Code 


Device 


PR: 


high-speed paper tape reader 


PP: 


high-speed paper tape punch 


CR: 


card reader 


MTJ3: to MT7: 


magtape units to 7 


LP: 


line printer 


DTJ& to DT7: 


DECtape units to 7 


KB: 


current user terminal 


KBn: 


Teletype n in the system 




NOTE 


the user can reference DTn: and MTn: where 
n is between and the maximum number of 
such units on the system. For example, 
normally only D10: and DTI: can be refer- 
enced on a RSTS-11 system. 
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2.6.4 Release Device, DEASSIGN Command 

The DEASSIGN command is used to release the specified device to the device pool within 
the system (for use by other jobs). If no device is specified, all assigned devices are released 
from that user (job number) . For example: 

DEASSIGN LP: 

releases the line printer. 

DEASSIGN 

releases all devices previously assigned by that user (under the current job number). If a 
DEASSIGN command is not given before the user leaves the system, an automatic DEASSIGN 
is performed when the user gives the BYE command. 
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CHAPTER 3 
SPECIAL CONTROL CHARACTERS 

3.1 RETURN KEY 

Typing the RETURN key echoes as a carriage return/line feed operation on the terminal, 
as long as the terminal is not in tape mode. The RETURN key is normally used to terminate a 
line and enter that line to the system. In tape mode (following entry of the TAPE command) all 
carriage returns are ignored. 

3.2 ESCAPE OR ALT MODE KEY 

The ESCAPE key, like the RETURN key, is used to terminate the current line and causes 
the line to be entered to the system. However, the ESCAPE key echoes on the terminal paper 
as a $ character and does not perform a carriage return/line feed. ESCAPE is used to enter the 
K EY command to the system . 

On some terminals the ESCAPE key is replaced by the ALT MODE key, which performs 
the same functions: 

3.3 LINE FEED KEY 

The LINE FEED key is generally used to continue the current logical line of input on an 
additional physical line. The LINE FEED key does not echo on the terminal paper but does per- 
form a carriage relurn/line feed operation when used with the RSTS-11 system. Typing the LINE 
FEED key automatically generates a physical, but not logical, carriage return/line feed sequence; 
so the LINE FEED is not used to terminate or enter lines to the system (except for the KEY command). 

LINE FEEDs produce errors in programs if included in constants (including string constants), 
verbs, or user-specified names for variables or functions. 

3.4 RUBOUT KEY 

The RUBOUT key is used as an eraser for the current line. If typed in tape mode, the 
RUBOUT key is ignored; otherwise, it causes the last character typed to be deleted. The erased 
characters are echoed on the terminal paper between backslashes. For example: 

10 LEF X=X*X 
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could be corrected by typing the RUBOUT key 7 times (to remove the F) and typing the remain- 
der of the line correctly. The line would look as follows on the terminal paper: 

10 LEF X=X*X\X*X=X F\T X=X*X 

and would appear to the system as: 

10 LET X=X*X 

In cases where the mistake is toward the beginning of a line, it may be easier to simply retype 
the entire line. For example: 

10 LEF X=X*X 
10 LET X=X*X 

Once the second line is entered to the system, the first line number 10 is deleted. 

RUBOUT can be used on any input line to the RSTS-11 system, including commands, as 
long as the line has not been entered to the system with RETURN or ESCAPE. 

3.5 aRL/C 

Typing a CTRL/C (hold down the CTRL key and type the C key, release both) causes 
RSTS-11 *n print READY and return to command mode where commands can be given or editing 
done. CTRL/C stops whatever RSTS-11 was doing at the time (execution or output) and returns 

control of the system to the user. 

Note that CTRL/C interrupts processing. For example, if CTRL/C is used after the REPLACE 
command is issued and before the READY reply is received, the file is not replaced in its entirety 
and is not closed. Since the file has not been closed, it cannot be accessed later. Similarly, 
if the OLD command is issued and a list of error messages is being printed, the CTRL/C key 
should not be used since the current program Is only half compiled at that point. 

3.6 CTRL/U 

The CTRL/U combination deletes the current input line. This is useful when a long command 
has been typed and is seen to be incorrect. Rather than use the RUBOUT key repeatedly, CTRL/U 
deletes the entire line. This feature can be used when typing either commands or statements. 

CTRL/U deletes the entire current physical line. For example: 

10 LEW A + U 

20 LET A= 

23.4 HJ 

LISTNH 

SYNTAX ERROR AT LINE 20 

READY 
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In typing line \0 a mistake was made and the line deleted with CTRL/U (notice that the line 
does not appear in the program listing following LISTNH). In typing line 20 , the LINE FEED 
key was used to continue line 20 onto a second line. A physical line has been terminated. 
The logical statement at line 20, however, is continued onto the following line and its 
deletion with a CTRL/U causes the statement at line 20 to be entered as: 

20 LET A = 

which is syntactically incomplete. Had the last line been terminated with the RETURN key it 
would be entered to the system as: 

20 LET A = 
23.4 

which would be accepted as equivalent to: 

20 LET A = 23.4 

3.7 aRL/O 

The CTRL/O combination suppresses output to the terminal until the next time CTRL/O 
is typed. When a program produces a large amount of output (usually tabular form), the user 
may not wish to wait for the printing of the complete information. CTRL/O enables the user to 
monitor the output while not stopping it completely. Typing CTRL/O while output is occuring 
still allows the computer to output the data, but the terminal does not print it. This speeds up 
the output process, since terminals are normally slow devices. The second time CTRL/O is 
typed, the output is again printed at the terminal. 

CTRL/C, on the other hand, completely terminates program output. Think of CTRL/O 
as a switch, the first setting of which creates a condition and the second setting releases the 
condition. 

3.8 TAB CHARACTER 

The TAB character or CTRL/I combination allows the user to insert a tabular format into 
his typed material. When entering a program to the system, the TAB character allows format- 
ting such as shown in Figure 3-1. The RSTS-11 editor considers each Teletype line to contain 
eigittab stops, eight spaces apart, across the line. Typing the TAB character causes the printer 
head to move to the next tab stop on the current line. 
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If using a model ASR-33 or KSR-33 Teletype, typing the TAB character echoes the 
appropriate number of spaces to reach the next tab stop. The model 35 Teletypes have hardware 
tab stops. (See the description of the TTYSET system program for a means to enable or disable 
hardware tabstops.) 

3.9 ctrl/z 

The CTRL/Z combination is used to mark the end of a data file. When data is input from 
a file, the CTRL/Z character marks the end of recorded data. The message "END OF FILE ON 
DEVICE" is printed by the system when a \Z is detected unless an ON ERROR GOTO statement 
is used to enable a BASIC-PLUS routine to handle the error (ERR =11). 



Ptf IF ^>P THK^S 

IF v=>C THFN) FM'MT "A>P>(" 
FL£"F IF r>0 

THF\j F-PIMT "OA>F" 
FL5.F FFI\) l "A>(>P" 
RF. C F \Y A>f "I HFvi FMsIT '•r>(s>r" 
VLi-Y IK r>c 

'iHF\i FF.Iv'l "T>(>(±" 
FL>F Frl'vJ'l "r>r>/\" 



Figure 3-1 TAB Character Example 
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CHAPTER 4 
RSTS-11 SYSTEM PROGRAMS 

In addition to the core-resident BASIC Compiler, there are several disk-resident system 
programs available on RSTS-11. The list of programs includes the following: 

LOGIN allows users to enter the system. 

LOGOUT allows users to leave the system. 

SYSTAT provides system status summaries. 

PIP moves data from one peripheral device to another . 

TTYSET allows the user to specify functional characteristics of the user ter- 

minal. 

GRIPE allows the user to log complaints or comments about the system . 

QUOLST allows the user to determine his current disk quota and the amount of 
file space in each system device. 

MONEY allows the user to determine the amount of time charged to hisr account 
number. 

The functions and techniques for using each program are described in the following sections. 

This Chapter was designed in a modular format so that the system manager could remove or 
add sections depending upon the needs of the individual installation. (The Table of Contents 
reflects the material supplied by DEC.) 
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4.1 LOGIN PROGRAM 

The LOGIN program is started when the command HELLO is typed at a user terminal or 
when any line is entered from a logged-out terminal. LOGIN connects a user terminal to 
RSTS-11, attaches a user to another job already running within the system, or permits the user 
to run designated system programs from a logged-out terminal. LOGIN can be called when the 
user first logs into the system or after the user is already logged into the system. 

The following are acceptable inputs from a logged-out terminal : 



Input Meaning Manual Section 



HELLO User wants to log into the system. 4.1 

HELP User wants a printed description of how to use the system. 

I Dataset has been answered and wants to log into the system. 

If the system has an automatic answering facility for remote 
terminals, the I character is inserted into the user input 
buffer by the system . 

other Undefined. LOGIN prints the message: PLEASE SAY HELLO. 

SYS User wants a system status report. 4.3 

SET xxxx User wants to set characteristics for that terminal , 4.5 



If the user input is SET xxxx or SYS, RSTS-11 attempts to run the system program requested. 
Only those programs listed above or others specified by the system manager can run while logged 
out of the system (see section 2. 1 .4) . 

In response to the HELLO command or the automatically inserted I character, where the 
issuing terminal is not logged into the system, the LOGIN program is started and performs the 
following: 

a. LOGIN prints the following information at the user terminal: the job number, key- 
board number, system version, and current system date and time. 

b. LOGIN then requests the user account number by printing a * character. The user 
types his project and programmer numbers in that order separated by a comma and 
terminated with the RETURN key. (Separating the numbers with a slash inhibits the 
printing of any opening system messages.) The user can specify his project-program- 
mer numbers on the same line as the HELLO command; for example: 

HELLO \0, 100 

(In this case, the system does not print * and only prompts the user to type his 
password, as shown below.) 
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c. LOGIN then requests a password by printing: 
PASSWORD: 

The password typed by the user does not echo at the terminal. 

d. If the account number and password are a valid entry, the user is logged into the 
system. If the codes typed by the user are not an acceptable entry, the message: 

INVALID ENTRY - TRY AGAIN 

ft 

is printed and the user can try entering another account combination. 

e. If there are any detached jobs' with the current account number, LOGIN then 
informs the user and permits him to attach to one of those Jobs (thus killing his 
current job number and removing it from the system). See the description below 
of attaching to another job. 

f. If the user does not attach to another job, LOGIN prints the message of the day, 
if any. 

g. Finally, the system prints 
NEW OR OLD - - 

to indicate that it is ready to accept command input. 
The complete sequence is shown below: 



HELLO 

RSTS V4A-11 SYSTEM #213 JOB 3 KB0 05-SEP-72 04:25 AM 

#100, 1J0J0 

PASSWORD: 

WELCOME TO RSTS -11 1 

NEW OR OLD— 



A job becomes detached either because of a dataphone disconnect affecting a remote user or 
due to deliberate action by deliberate use of a certain system function within that job program. 
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If the HELLO command is input from a terminal already logged into the system, LOGIN 
performs the following: 

a. LOGIN prints two lines identifying the system version, job number, keyboard, date, 
time and account number. 

b. If there are any detached jobs with the current account number, LOGIN permits 
the user to attach to one of those jobs (which kills his current job number and re- 
moves it from the system). The job number to be typed by the user is the job number 
as printed by the system following the HELLO command. For example: 



HELLO 

RSTS-11 V4A-J05 SYSTEM # 213 JOB 3 KB4 I0-SEP-72 ljeJ:0j3 AM 

YOU ARE LOGGED IN UNDER \60, W 

JOB(S) 2 ARE DETACHED UNDER THIS ACCOUNT 

TYPE JOB NUMBER TO ATTACH TO? 2 

ATTACHING TO JOB 2 

The job number specified must be the original job number assigned when the current- 
ly detached job was logged into the system. 

c. To avoid attaching to another job, type the RETURN key instead of specifying a 

job number. 



4-4 



4.2 LOGOUT PROGRAM 

LOGOUT is called when the user has completed all processing and is ready to leave the 
terminal. The LOGOUT program is started when the BYE command is typed at a user terminal 
logged into the RSTS-1 1 system. LOGOUT checks the current user's disk quota to ensure that 
the user does not log out of the system with more than the acceptable amount of disk storage 
being used for his files. If the user's disk files are within the acceptable disk quota size, 
LOGOUT disconnects the terminal from the system, removes the current job number from the 
list of active |obs and prints some information on the duration of the current job. 

In response to the BYE command, LOGOUT prints: 

CONFIRM: 



The user can give any of the following responses: 



Table 4-1 



LOGOUT CONFIRM: Responses 



CONFIRM: Response 


Meaning 


N "J 

CTRL/C J 


These responses indicate that the user does not want to log out of 
the system. The LOGOUT procedure is terminated without logging 
the user off the system and the system prints NEW or OLD-- 


? 


Causes the system to print an explanation of the acceptable responses 
to CONFIRM: 


RETURN key 


Causes the system to print a message instructing the user to type ? 
to obtain a description of logout procedures. 


1 


Causes LOGOUT to enter individual file deletion mode. 


Other 


Causes the user to be logged out of the system as long as his disk 
storage space is within the acceptable limits. 



In individual file deletion mode, LOGOUT prints the name, size, protection code, and 
creation date of each file stored under the current user account number on the system disk. This 
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information is followed by a ? after which the system awaits a response from the user which 
can be: 



File Deletion 
Mode Response 



Meaning 



RETURN key 
K 



Save the file just listed. 
Delete (kill) the file Just listed. 



An example of a LOGOUT sequence is shown below: 

BYE 

CONFIRM: YES 

DISK QUOTA OF 500 EXCEEDED BY \0 BLOCKS 

SOME FILE(S) MUST BE DELETED BEFORE LOGGING OUT 

CONFIRM: I 

FOOBAR.BAS 450 60 10-JAN-72 ? 

FOO .TMP 60 60 10-JAN-72 ? K 

CONFIRM: YES 

SAVED ALL DISK FILES: 450 BLOCKS IN USE, 50 FREE 

JOB 1 USER ]0,]00 LOGGED OFF KB4 AT 1J3-JAN-72 10:00 AM 

SYSTEM RSTS-1T V4A-05 SYSTEM #213 

RUN TIME WAS 1 MINUTE. 20.1 SECONDS 

ELAPSED TIME WAS 20 MINUTES. 15 SECONDS 

GOOD MORNING 



LOGOUT statistics for a detached job, or a job which was detached at any time, include 
accumulated run time and elapsed time statistics. 
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4.3 SY5TAT PROGRAM 

The SYSTAT program provides current system information in the areas of job, device, 
disk, and buffer status. SYSTAT can be called by a user logged into the system or from a ter- 
minal which is on-line but not logged into the system. 

To start SYSTAT while logged into the system, type: 

RUN SSYSTAT 
If not logged into the system, type: 

SYS 
If the user is already logged in, the system responds by printing: 

OUTPUT STATUS TO? 

at which point the user can indicate any RSTS-11 device or a filename specification for the 
status report output. Possible replies by a user logged into the system are described below: 



SYSTAT 


Output Response 


Meaning 


LP: 






send status report to the line printer. 


KB: 






send status report to the user terminal. (The RETURN key is equivalent 
to responding KB:) 


KBn: 






send status report to user terminal n in the system if that terminal is 
on-line and not currently in use. 


PP: 






send status report to the high-speed paper tape punch. 


dev:filename 


.ext 


send the status report to the file specified. The default device is the 
system device. No extension is appended unless specified by the user. 



If SYSTAT is run by a user not logged into the system, the report is always sent to the user 
terminal requesting the report. 

Following the device or filename specification, the user can specify one of the options 
in Table 4-2 to obtain a partial system status report. The option specifications are preceded 
by a slash if the user is logged into the system. The options can be typed following the SYS 
command if the user is not logged into the system. 
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Table 4-2 
SY5TAT Options 



SYSTAT Option 
Specification 


Meaning 


S 


report only job status 


B 


report only busy device status 


D 


report only disk status 


F 


report only free buffer status 


Kn 


report only the status of terminal n in the system 


DET 


report only the status of detached jobs^ 


n,m 


report only the status of any jobs active under account r n / m ] 


0,0 


report only the status of jobs not logged into the system 



The options S,B,D, and F can be specified as separate options or in any combination. 

The following examples are performed on a terminal logged into the system: 

RUN$ SYSTAT 

OUTPUT STATUS TO? LP: /3 causes output of a status report for job 3 to the line printer . 

RUN$ SYSTAT 

OUTPUT STATUS TO? /D causes output of disk status report to the user terminal. 

RUNS SYSTAT 

OUTPUT STATUS TO? /SF causes output of job and free buffer status to the user 

terminal. 

The following examples are performed on a terminal not logged into the system: 

causes output of complete system status report to the terminal, 
causes output of the disk status report to the terminal. 

causes output of the busy device and free buffer status reports to the 
terminal . 

equivalent to not specifying any options; a complete system status 
report is output to the terminal. 

causes output of a status report for job 5 to the terminal. 



SYS 




SYSD 


SYS 


BF 


SYS 


SBDF 


SYS 


5 



Normally, a job is detached only by use of a certain system function or because of a dataphone 
disconnect affecting a remote user. 
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A complete system status report is shown below: 



RUN$SYSTAT 
OUTPUT STATUS TO? 



RSTS V4A-11 SYSTEM #213 STATUS ON 05-SEP-72 AT 04:42 AM UP: 1:34:42 



JOB WHO 

1 100, 101 

2 100,100 

3 100, 100 

4 1, 10 


WHERE WHAT 
KB6 LOGOUT 
KB 10 NO NAME 
KB0 SYSTAT 
KB9 MONEY 


SIZE STATE 
2K RN SW 
2K KB 
5K RN 
5K FP 


RUN-TIME 
6.7 
0.9 
0.9 
0.3 


BUSY DEVICES: 

DEVICE JOB WHY 

LP 1 AS 








DISK STRUCTURE: 








DISK OPEN FREE 
DKjEf 686 
DKl 2 139 


CLUSTER ERRORS 

1 

2 


COMMENTS 

PUBLIC 

PRIVATE 




SMALL LARGE ERRORS 
43 1 


HUNG TTY'S 








READY 

Run time is given in 

hours: minutes: seconds ► tenths of seconds 



For example: 



1:23.4 



indicates one minute, 23.4 seconds of run time. 

The job status information includes a list of all current active jobs by job number. 
Associated with each job number are the account number, the keyboard number, the current 
program name and size, the job state and elapsed run time associated with that job. 

The device status information reports devices which are busy, having been assigned, or 
opened by a specific user. Items reported are the device specification, the job owning that 
device, and the condition of the device. 
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The disk status information describes each disk (public and private) currently mounted. 
Items reported are: disk name (device specification), number of open files, number of free 
512-byte blocks, pack cluster size, disk hardware error count, and the public/private and 
locked/unlocked status of the device. 

The buffer status provides information on the number of small (16-word) and large (256- 
word) buffers currently not in use, catastrophic error count, and a count of the number of times 
a hung terminal was found. A hung terminal is one which fails to respond to character transmis- 
sion within a given time period. The system attempts to unhang the terminal and increments 
the hung terminal count. 

The abbreviations used inthe SYSTAT report are defined in Table 4-3. 

Table 4-3 
SYSTAT abbreviations 



Abbreviation 


Meaning 


DET 


job is detached from all terminals 


/ 


job is not logged into the system but is running LOGIN, SYSTAT, or 




TTYSET 


SW 


job is swapped out (not currently in core) 


RN 


job is running or waiting to run 


RS 


job is waiting for residency following an I/O operation 


HB 


job is detached (waiting to be attached) 


FP 


job is waiting for file processing action by the system. 


SL 


job is sleeping (SLEEP statement) 


CR 


job is waiting for card reader input 


MT 


job is waiting for magtape I/O 


LP 


job is waiting to perform line printer output 


DT 


job is waiting for DECtape I/O 


PP 


job is waiting to perform output on the high-speed paper tape punch 


PR 


job is waiting for input from the high-speed paper tape reader 


TT 


job is waiting to perform output to a terminal 


KB 


job is waiting for input from a terminal 


DF 


job is waiting to perform disk I/O 


AS 


device is explicitly assigned to a job 


INIT 


device is open on a channel 
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4.4 PIP PROGRAM 

The PIP (Peripheral Interchange Program ) system program performs disk and peripheral 
device transfers as well as several other file utility functions. Two forms of the PIP program are 
available; the only difference being that one contains Record I/O copy options and is present 
only on systems having the Record I/O feature. Non-Record I/O PIP can perform only formatted 
ASCII file transfers. (RSTS-11 PIP commands, wherever possible, have been made compatible 
with DOS- 11 PIP commands). 

PIP can only be called by users logged into the system as follows: 

RUN$ PIP 

PIP responds by identifying itself and printing an asterisk to indicate that it is able to accept 
input commands: 

PIP RSTS V4A-11 SYSTEM #213 
* 

In order to return to the RSTS-1 1 Monitor, type CTRL/C or CTRl/Z. The system responds 
by printing READY. For example: 

HZ 
READY 

A CTRL/Z is equivalent to an End-of-File on the user terminal and causes an orderly exit from 
PIP, as does CTRL/C. 

4,4.1 PIP Command Line Specifications 

Spaces and tabs within a PIP command line are ignored. PIP commands must be typed on a single 
line and be no more than 80 characters long. 

Output file specifications are of the form: 

dev: [proj, prog] name.ext < prot > 

The elements of the output file specification are described in Table 4-4. Input file specifica- 
tions are of the form: 

dev: [proj, prog] name.ext 
Elements of the input file specification are described in Table 4-5. 
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Table 4-4 
Output File Specification Elements 



Element 




Description 




Default 


dev: 




device specification 




system disk (DF:) 


[ pro j, prog] 


account specification, proj 
programmer number 


ect- 


current user account number 


name 




filename specification 




none 


.ext 




filename extension 




none 


<prot > 




protection code 




< 60 >, equivalent to read and write protect 
against everyone but the owner 


no specification 




KB: 


'Output-only devices (non-file-structure 
name and extension specifications. 


d devices) such as KB:, LP: and PP: ignore the file- 



Table 4-5 
Input File Specification Elements 



Element 


Description 


Default 


dev: 


device specification 


system disk (DF:) 


[proj, prog] 


account specification, project- 
programmer number 


current user account number 


name 


filename specification' 


none 


.ext 


filename extension' 


.BAS (BASIC-PLUS source program) 


no specificat 


ion 


last file specification is used again. 
Initial default is DF: 


Input-only devices (non-file-structured devices) 
the filename and extension specifications. 


such as KB:, PR: and CR: ignore 



With PI P there is at most one output file, but there may be any number of input files. 
Where more than one input file is specified, all filenames which are not preceded by a device 
specification are assumed to be on the system disk. A null file specification duplicates the 
immediately preceding file specification in all details. 
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PIP options are specified in the form: 

/option:argument 

Options are always begun with a slash and terminated with a comma (,), left angle bracket (<), 
another slash (/), or a line terminating character (RETURN or ESCAPE). The option argument 
is a function of the individual operation to be performed. The default option is a formatted 
ASCII file transfer. 

4.4.2 File Transfers Including Merge Operations 

File transfer and/or file merge operations take the following command format: 

*output file < input file(s) /option 

Only one output file can be specified. If one input file is specified, a copy of that file 
is transferred to the output file specification (the original input file remains untouched). If 
more than one input file is specified, copies of the files are merged into a single output file 
(the original input files remaining untouched). The options available on a file transfer and/or 
merge operation are described in Table 4-6. 

As an example: 

RUN$ PIP 

PIP RSTS V4A-11 SYSTEM #213 

*DT1:FILET.BAS<F!LE1,FILE2,PR:,DT0:AA.BAS 

The above command string takes the files FILE! and FILE2 from the system disk, a single file 
from the high-speed paper tape reader and file AA.BAS from the tape reel mounted on DECtape 
unit )Zf and creates the single file FILET. BAS on the tape reel mounted on DECtape unit 1. 

Since a PIP command must be typed on a single line, the number of files which can be 
merged into a single file is limited only by a command string length of 80 characters. 

4.4.3 Change Filename or Protection Code 

PIP can be used to change a filename specification. The general format for such a command 
is as follows: 

*new file specification = old file specification 

To change the filename, extension and/or protection code of a stored file, type the new file 
specification (including the device specification and, optionally, the protection code), followed 
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Table 4-6 
File Transfer and Merge Options 



Option 




Function 


no option 




ASCII file transfer is performed. 


/FA 




Formatted ASCII transfer is performed (Nulls, parity bits , 
and RUBOUT's are ignored). 


/BL 




Block mode transfer is performed using the default block 
sizes. 1 


/BL:n 




Block mode transfer is performed using a block which is n 
bytes long. 


/CO 




Contiguous mode transfer is performed with null fill char- 
acters inserted into any partial buffer remaining. 


/CO:T 




Contiguous mode transfer is performed with any partial 
buffer remaining being truncated.^ 


/CL:n 




Set cluster size to n. 


/ GO 




Ignore 'USER DATA ERROR ON DEVICE 1 errors. 


/HE 




Appends '$PIP.TXT' to command line to have PIP output 
the helping text explaining PIP commands and options. 


/UP 




Update file transfer (equivalent to OPEN AS FILE used 
for output files). 


'Parity bits are associated with some ASCII codes, making each ASCII character 
8 bits long rather than 7 bits. The DOS/BATCH Monitor system uses even parity 
ASCII. Even parity implies that the number of bits set within the 8 bit field is 
an even number. 


^Available 


only with the Record I/O version PIP program. 
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by an equal sign (=), followed by the current file specification. The current protection code 
need not be indicated. For example: 

*FILE.EXT<4j3>=ABC.DAT 

In this example, the filename, extension, and protection code are changed. The file is stored 
on the system disk, the default device. 

*DTl:MAT.BAC=DTl:ORIG.BAC 

In this example only the filename is changed. The protection code for the file MAT.BAC re- 
mains the same as it was for ORIG.BAC. 

In the case where only the protection code is to be changed, a new filename specification 
need not be typed . A shorter form is: 

* = old file specification < prot> 



or 



* = old file specification < prot> /RE 



where the /RE (rename) option is assumed if not specified. This command string format indicates 
that the file specification is to be updated. For example: 

*=MAG.BAS <48> 

Notice that the device specification on both sides of the equal sign must be the same. If it is 
desired to move the file from one device to another, the file merge technique (see section 
4.4.2) is used. Note also that PIP assumes a default filename extension of .BAS on input files, 
but an extension must be specified on output files or none is appended. 

4.4.4 File Deletions 

To remove a file from the system, type the file specification followed by the /DE (delete) 
option. For example: 

*TRY2.BAC/DE 

This command string causes the file TRY2.BAC to be removed from the system disk if found under 
the current user's account number. No default assumptions are made as to the filename exten- 
sion. An extension must be specified if the file was stored with an extension. 
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The user cannot delete a file under another account or a file which is write-protected 
against him. If an attempt is made to delete a non-existent file from a device, the error mes- 
sage CAN'T FIND FILE OR ACCOUNT is given. 

More than one file can be deleted by specifying several file specifications, separated 
by commas. For example: 

*FILE1.BAC,FILE2.BAC,DT1:FILE1.BAC/DE 

deletes FILE1.BAC from both the system disk and DECtape unit 1 and deletes FILE2.BAC from 
the system disk. The number of files which can be deleted in one PIP command string is limited 
only by the maximum length of the command line. 

4.4.5 Z ero Device Directory 

Zeroing a device directory removes all files stored under one account number on the 
given device. In order to perform this operation, log in to the system under that account num- 
ber (with the correct password) and run PIP, giving the device specification followed by the 
/ZE (zero) option: 

RUN$ PIP 

PIP RSTS V4A-11 SYSTEM #213 

*/ZE 

This command removes all files stored on the system disk for the current account number. 

*DT1: /ZE 

removes all files on the tape reel mounted on DECtape unit 1. (No file protection is available 
for files on DECtape reels; hence, any user can zero any DECtape reel.) 

4.4.6 List Device Directory 

The user can request a listing of all files under his account number, all files with a given 
name or extension under his account number, or a particular file under his account number on 
the system disk or any one or more devices. The format of the directory listing command is as 
fol lows: 

* output < input file(s) /option 
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An output file specification can be supplied where an output device other than the user terminal 
is desired. The more usual form of the command is: 

*input file(s) / option 

in which case the directory listing is sent to the terminal Issuing the command. Unlessanother 
device is specified, only a directory of the system disk is printed. For example: 

RUN$ PIP 

PIP RSTS V4A-U SYSTEM ^213 

*, DTJ0:, DTb/DI 

will cause a full directory listing of files for the current user on the system disk (The blank 
device specification, indicated by the comma with no preceding characters indicates the 
system disk), and on DECtape units and 1. 

The options available with device listings are described in Table 4-7.- The input file 
specifications are described in Table 4-8. 



Table 4-7 
PIP Directory Listing Options 



Option Function 



/BR BRief directory listing is printed; includes only filenames and 

extensions with four file specifications on each printed line. 

/Dl Normal Directory listing is printed; includes filename, exten- 

sion, length, protection code, and creation date. 

/DI:S Full (Slow) directory listing is printed; includes: 

a. for disk devices: filename, extension, length, protection 
code, creation date and time . 

b. for magtape or DECtape: filename, extension, length, 
protection code, creation date. 
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Table 4-8 
Input File Specifications 



Input File 




Directory Printed Includes 


none 




all files on the system disk under the current user account 
number . 


dev: 




all files under the current user account number on the 
device specified . 


dev:*.* 




same as the above. 


dev:filename.* 




all files having the filename specified, under the current 
user account number, on the device specified. 


devrname.ext 




only the file specified, under the current user account 
number, on the device specified. 


Where no device is specified, the default device is the system disk; no message is 
printed if the particular input file spec if i cation (s) cannot be found; where several 
input file specifications are given, they are separated by commas. Account num- 
bers are only significant for disk files. 



Sample directory listing specifications are shown below: 

*/BR 
*DTJ3 : /Dl 

* *.BAC/DI:S 

* $/DI 
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4.5 TTYSET PROGRAM 

The TTYSET system program is used to establish terminal characteristics for the user ter- 
minal. TTYSET can be run by any user before or after he is logged into the system. If the ter- 
minal is not logged into the system, only one command can be entered to the TTYSET program 
at a time in the following format: 

SET xxxx 

where xxxx represents one of the TTYSET commands shown in Table 4-9 and is entered with 
the RETURN or ESCAPE key. If the user is logged into the system, he can run TTYSET as follows: 

RUNS TTYSET 

'TTYSET' TERMINAL CHARAaERISTICS PROGRAM 

?xxxx 

where xxxx is again one of the TTYSET commands shown in Table 4-9. When xxxx has been 
entered to the system with the RETURN or ESCAPE key, TTYSET again prints ? to accept 
additional commands. To return control to the RSTS-11 Monitor, type EXIT, CTRL/C, or 
CTRL/Z. 
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Command 



EXIT 
HELP 
TAB 

NO TAB 
FORM 

NO FORM 

LC 

NO LC 

XON 
NOXON 
ECHO 
NO ECHO 
SCOPE 

NO SCOPE 
ESC 

NO ESC 

WIDTH n 
SPEED n 



Table 4-9 
TTYSET Commands 



Function 



Standard 
Condition 



Exit from the TTYSET program; return control to RSTS-11 Monitor. 

Print a description of the other TTYSET commands. 

Enable hardware tab control by the terminal (significant for 
AS R-3 5 Teletypes). 

Disable hardware tab control by the terminal (significant for 
ASR-33 Teletypes). 

Enable hardware form feed control by the terminal (significant 
for ASR-35 Teletypes). 

Disable hardware form feed control by the terminal (significant 
for ASR-33 Teletypes). 

Enable sending of lower case letters (useful with some terminals, 
ignored by others.) 

Translate all lower case letters sent by the terminal into upper 
case letters. 



Set 



Set 



Set 
Set 



Enable XON/XOFF remote low-speed reader control. 

Disable XON/XOFF remote low-speed reader control. 

Enable terminal echo facility; results in full duplex mode operation. Set 

Disable terminal echo facility; results in half duplex mode operation. 

Enable terminal CRT cursor controls (only significant when 
issued from a CRT display terminal). 



Disable terminal CRT cursor controls . 

Treat only ASCII 033 (octal) code as ESCAPE (ESCAPE or 
ALT MODE key). 

Treat ASCII 033 , 175, 176 (octal) as ESCAPE (ESCAPE or ALT 
MODE key). 



Set 



Set 



Set the terminal form width to n characters where l<_n<254 (octal). WIDTH 72 

Set DC1 1 baud rate to DCl 1 speed n where 0<n<3 (the actual baud SPEED 
rate corresponding to n is dependent upon the particular DC11 
referenced. 
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Table 4-9 
TTYSET Commands (cont'd.) 







Standard 


Command 


Function 


Condition 


FILLn 


Set fill factor of n, which is multiplied by the default fill 
factor (see Appendix B of the RSTS-11 System Manager's 
Guide). 




NO FILL 


Set fill factor of ji. 


Set 


FILL LA3/3 Set special LA3J0 serial (DECwriter) fill factor. 




KSR33 

ASR33 

KSR35 

ASR35 

VTJ85 

VT06 

LA30 

LA30S 


Treat terminal as though it were the indicated device. 
These commands automatically select, from the preceeding 
commands, those features applicable to the respective terminal. 


Set 
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4.6 QUOLST PROGRAM 

The QUOLST system program allows the user to determine what portion of his disk quota 
is currently occupied and the number of free blocks remaining on the system disk. QUOLST is 
called as follows: 

RUN$ QUOLST 

Output from QUOLST includes the user account number and information printed under the 
following headings: 



Table 4-10 
QUOLST Column Headings 



Column Heading Meaning 



STR STRu cture, device being reported. 

USED number of used 256-word blocks under the user account. 

FREE number of free blocks remaining in the user account disk quota , 

SYSTEM number of free blocks remaining to the system on the structure 

indicated . 



Output from QUOLST looks as follows: 

RUN $QUOLST 

USER: lW,Wl 

STR USED FREE SYSTEM 

DF: 55 145 1234 

DK1: lj3 1992 1992 



In this example, the user is logged into the system under account [100, 1J0J0] and has 
used 55 blocks on the system disk(s) with a quota of 20 blocks (20 -55=145 free blocks). 
There are 1234 free blocks on the system disk(s). User [l/20, ]0] also has access to private 
disk DK1: He has used lj3 blocks on DK1: and has no disk quota on that device; therefore, 
the free user block count is equal to the free system block count (1992 blocks). 
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4.7 MONEY PROGRAM 

MONEY is the RSTS-11 system accounting program which allows a user to obtain printed 
data on his own account status. The program is called as follows (only by a user logged into 
the system) : 

RUN$ MONEY 



The following shows Teletype output resulting when a user logged into the system under 
account [lOO, 100] runs the program MONEY: 



ACGT PASSWORD CPU- TIME KCT'S CCMMECT DEVICE ACCESS DT SK CUO'iV-- 
IPfi, ].C0 57.5 3570 24:33 8 7 30E 500 

READY 
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CHAPTER 5 
RSTS-11 PERIPHERAL DEVICES 

RSTS-11 has several peripherals which are available to the user. These devices include: 

user terminals (ASR-33, ASR-35, DECwriter, VT05 display) 

high-speed paper tape reader/punch 

card reader 

line printer 

DECtape 

magtape 

While normal operation of a computer system is by programmed control, manual operation is 
necessary for some tasks. This Chapter describes the manual control and operation of the 
common RSTS-11 user peripherals. Chapter 12 in the BASIC-PLUS L anguage Manual describes 
device usage for the transfer of information between peripheral equipment and the BASIC- 
PLUS program. 

5.1 ASR-33 Teletype 

The ASR-33 Teletype is an inexpensive, commonly employed user terminal. 
Major features are noted in Figure 5-1 . 




Figure 5-1 ASR-33 Teletype Console 
The components of the Teletype unit and their functions are described on the following page. 
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5.1.1 Control Knob 



The control knob of the ASR-33 Teletype console has three positions: 

LINE The console has power and is connected to the system as an I/O device 

under RSTS-11 control. 

OFF The console does not have power. 

LOCAL The console has power for off-line operation under control of the 
keyboard and switches only. 

5. 1 .2 Keyboard 

The Teletype keyboard shown in Figure 5-2 is similar to a typewriter keyboard, except 
that some nonprinting characters are included as upper case elements. For typing characters or 
symbols such as $, %, or * which appear on the upper portion of numeric keys and some alpha- 
betic keys, the SHIFT key is depressed while the desired key is typed. 



Nonprinting operational functions are shown on the upper part of some alphabetic keys. 
By depressing the CTRL (control) key and typing the desired key, these functions are activat 
Use of these CTRL/key combinations are described in Chapter 3 of this manual. 



OOQ(DQ(DOQQOOQ© 

§oo©@©oo@©©§§ 
eo@®©©oo©©o§ee 

0OOOOO(D©OOO0 



Figure 5-2 Teletype Keyboard 



' Although not shown on most keyboards, SHIFT/L produces the backslash character (\) and 
SHIFT/K and SHIFT/M produce the square brackets [and ], respectively. 
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5.1.3 Printer 



The Teletype printer provides a printed copy of input and output at ten characters per 
second, maximum rate. When the Teletype unit is on-line to the system (control knob turned 
to LINE), the copy is generated by the computer (even the echoing of the characters typed 
by the user); when the Teletype unit is off-line (control knob turned to LOCAL), the copy is 
generated directly from the keyboard onto the printer as a key is struck. 

5.1.4 Low-Speed Paper Tape Reader 

The paper tape reader is used to read data punched on eight-channel perforated paper 
tape at a rate of IJZf characters per second, maximum. The reader controls are shown in Figure 
5-1 and described below. 

START The reader is activated; reader sprocket wheel is engaged and operative. 

STOP The reader is deactivated; reader sprocket wheel is engaged but not 

operative. 

FREE The reader is deactivated; reader sprocket wheel is disengaged. 

The following procedure describes how to properly position paper tape in the low-speed 
reader. 

a. Raise the tape retainer cover. 

b. Set reader control to FREE. 

c. Position the leader portion of the tape over the read pi ns with the sprocket 
(feed) holes over the sprocket (feed) wheel and with the arrow on the tape 
(printed or cut) pointing outward (forward) . 

d. Close the tape retainer cover. 

e. Make sure that the tape moves freely (if the tape does not move back and 
forth freely, the paper feed holes are not properly positioned). 

f. Set reader control to START, and the tape is ready. 
5.1.5 Low-Speed Paper Tape Punch 

The paper tape punch is used to perforate eight-channel rolled oiled paper tape at a max- 
imum rate of 1J3 characters per second. The punch controls are shown in Figure 5-1 and 
described on the following page. 
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RELease 
B.SP 

ON (LOCK ON) 
OFF (UNLOCK) 



Disengages the tape to allow tape removal or loading. 

Backspaces the tape one space for each firm depression 
of the B C SP button. 

Activates the punch. 

Deactivates the punch. 



Blank leader/trailer tape is generated by: 

a. Turning the control knob to LOCAL. 

b. Turning the punch control to ON. 

c. Typing the HERE IS key. 

d. Turning the punch control to OFF. 

e. Turning the control knob to LINE. 

5.2 HIGH-SPEED PAPER TAPE READER AND PUNCH UNITS 

One high-speed paper tape unit can be provided with each RSTS-11 system. This unit is 
mounted on the central computer console. A high-speed paper tape unit is pictured in 
Figure 5-3 and descriptions of the reader and punch units follow. 
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Figure 5-3 High-Speed Paper Tape Reader/Punch 



5.2.1 High-Speed Reader Unit 

The high-speed paper tape reader is used to read data from eight-channel , fan-folded 
(non-oiled), perforated paper tape photoelectrical ly at a rate of 3J0J0 characters per second, 
maximum. 

NOTE 

Tape from the Teletype punch should not 
be used with the high-speed reader as the 
oil on the tape causes lint and dust to 
collect on the photoelectric cells. 

Primary power is applied to the reader when the computer power is on. 

In order to use the high-speed reader as an input device, turn the reader ON LINE/OFF 
LINE rocker switch to ON LINE. Load tape into the reader as explained below: 

a. Raise the tape retainer cover. 

b. Place tape in right-hand bin with printed arrows pointing toward left-hand bin. 
(Channel one of the tape is toward the rear of the bin.) 

c. Place several folds of blank tape past the reader and into the left-hand bin. 

d. Place the tape over the reader head with feed holes engaged in the teeth of the 
sprocket wheel . 

e. Close the tape retainer cover. 

f. Depress the FEED rocker switch until leader tape is over the reader head. 

The reader is capable of sensing whether a tape is in the reader. If an attempt is made to 
read a tape when the reader is either empty or OFF LINE, an error is generated. 

5.2.2 High-Speed Punch Unit 

The high-speed paper tape punch is used to record computer output on eight-channel , fan- 
folded, non-oiled paper tape at a rate of 50 characters per second maximum. All characters are 
punched under program control from the computer. Blank tape (feed holes only, no data), is 
produced by pressing the punch FEED rocker switch. The punch unit has power turned on when- 
ever the computer has power; it does not require any additional on/off switch. 

Fan-folded paper tape is generally grey in color. When a box of tape is nearly empty, 
purple tape is produced. Rather than risk running out of tape while punching, replace the box 
of paper tape at this point or notify the system manager who will replace the tape. 
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5.3 CR 11 CARD READER 

The CR11 card reader allows the RSTS-11 system to accept information from punched 80 
column data cards. Cards can be read under program control at rates of up to 20,0 or 3J00 cards 
per minute. 

Power to the reader, shown in Figure 5-4, is controlled by the ON/OFF switch on the 
upper left hand corner of the back panel. Two toggle switches are present on the back panel 
and should be set to AUTO and REMOTE for proper operation. The LAMP TEST button on the 
reader back panel can be depressed to check the operation of the various reader lights on the 
front panel . 

In order to use the card reader: 

a. Remove card weight from input hopper. Place cards loosely in input hopper. The 
first card to be read is placed at the front of the deck, "9" edge down, column 1 
to the left. Replace card weight on top of cards in input hopper. Cards should not 
be packed tightly. 

b. Press green RESET button. Wait 4 seconds for RESET light to come on. The card 
deck is now able to be read under program control. 

c. Cards may be loaded while the reader is operating provided tension is maintained on 
the front of the deck as cards are added to the rear. Additional cards should not be 
loaded until the hopper is 1/2 to 2/3 empty. 

d. The outpjt stacker bin can be unloaded while cards are being read. Care should be 
taken to maintain the order of the deck. 



The various lights and switches (buttons) on the reader front panel and their significance are 
described in Table 5-1. 

Table 5-1 
Card Reader Controls 



Light/Switch 



POWER 
READ CHECK 

PICK CHECK 

STACK CHECK 



Function 



light indicates that there is power to the reader. 

light indicates a reading error, torn card, or card too long for reader. 
Reader stops and RESET light is out. 

light indicates inability to remove card from input hopper. Reader stops 
and RESET light is out. 

light indicates inability to remove card from input hopper. Reader stops 
and RESET light is out. 
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Table 5-1 (cont'd.) 



Light/Sw 


itch 


Function 


HOPPER CHECK 


light indicates that there are no cards in input hopper or the output 






stacker is full. Condition must be manually corrected to allow further 






operation. 


STOP 




button, when depressed, causes red light to go on momentarily. RESET 
light goes out and reader operation stops as soon as the card currently 
in the read station has been read. 


RESET 




button, when depressed, causes green RESET light to go on and initial- 
izes card reader logic. 




Figure 5-4 
CR11 Punched Card Reader 



5.4 LP11 LINE PRINTER 



The LP11 line printer, pictured in Figure 5-5, has an 80 column capacity, prints at a 
rate of 356 lines per minute at a full 80 columns, and can print 1 1,0,0 lines per minute at 20 
columns. These rates are based on a 64-character set. A 96-character set and 132-column 
version are also available. The print rate is dependent upon the data and number of columns to 
be printed. 
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Characters are loaded into a 20-character printer memory via a Line Printer Buffer. 
When this buffer is full, the characters are automatically printed. This process continues until 
the 80 columns (four print zones) have been printed or a carriage return, line feed, or form feed 
character is recognized. The printer responds only to codes representing the character set and 
three control characters. All other codes are ignored. 




Figure 5-5 
LP1 1 Line Printer System (80-column model) 

5.4. 1 Line Printer Character Set 

The 64 character set consists of the 26 upper case letters (A - Z), ten numerals (0-9), 
and the space character. The 96-character set contains all of the above plus 26 lower case 
letters and 6 additional symbols. The character codes are 7-bit ANSCII. 

Characters are printed lj3 characters per inch and 6 lines per inch. 

Line printers can use paper varying in width from 4 inches to 9-7/8 inches for the 80-column 
printer. Forms making up to six copies can be used when multiple copy printing is desired. 
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The special synbols available are as follows: 
64-character set 



11 * $ % & ' ( ) 



= 9 



• / ; 
\ [ ] 



96-character set 

all of the 64-character 
set symbols 

- { } Z - DEL 



ASCII numeric equivalents for the various characters are contained in Appendix D. 

5.4.2 Line Printer Operation 

Figure 5-6 illustrates the line printer control panel on which are mounted three 
indicator lights and three toggle switches. Operation of these switches and the power switch, 
and the meaning of the lights is explained in Table 5-2. 
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Figure 5-6 Line Printer Control Panel 



Table 5-2 
Line Printer Controls 



Light/Switch 


Function 


POWER light 


Glows red to indicate main power switch (located inside cabinet) 
is at ON position and power is available to the printer. 


READY light 


Glows white, shortly after the POWER light goes on to indicate 
that internal components have reached synchronous state , paper 
is loaded, and the printer is ready to operate. 


ON LINE light 


Glows white to indicate that ON LINE/OFF LINE toggle 
switch is in ON LINE position. 
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Table 5-2 (cont'd.) 



Light/Switch 



Function 



ON LINE/OFF LINE switch 



TOP OF FORM switch 



PAPER STEP switch 



This three-position toggle switch is spring-returned to center. 
When momentarily positioned at ON LINE it logically connects 
the printer to the computer and causes the ON LINE light to 
glow. Positioned momentarily at OFF LINE, the logical con- 
nection to the computer is broken, the ON LINE light goes off, 
and the TOP OF FORM and PAPER STEP switches are enabled. 
If printer is switched to OFF LINE, the ON LINE light remains 
on until either PAPER STEP or TOP OF FORM switch is activated. 
The printer should again be turned ON LINE. 

This two-position toggle switch is tipped toward the rear of the 
cabinet to roll the form to the top of the succeeding page. It 
is spring-returned to center position, and produces a single top- 
of-form operation each time it is actuated. The switch is effec- 
tive when the printer is off line. 

This two-position toggle switch operates similarly to TOP OF 
FORM but produces a single line step each time it is actuated. 
It is only effective when the printer is off line. 



ON/OFF (main power) switch This switch controls line current to the printer. To gain access 

to it, the printer front panel is unlatched, by pushing the 
circular button on the right hand edge, and opened to the left 
on its hinges. The switch is located to the left of center approx- 
imately fourteen inches below the top. If power is available, 
the red POWER light on the control panel will glow when the 
switch is positioned at ON. 

The switch is on when in the up position. The ON and OFF 
labels are printed on the stem of the switch. A group of two 
switches and three indicator lights, above the main power 
switch, are for the use of technicians in making initial adjust- 
ments to the printer. 

The following procedure is used when loading paper in the line printer. 

a. Open front door of cabinet. POWER light should be on. Printer should be off line. 

b. Lift control panel TOP OF FORM switch and release to move tractors to correct 
loading position. 

c. Open drum gate by moving drum gate latch knob to left and up. Swing drum gate 
open. 

d. Adjust right hand tractor paper width adjustment for proper paper width if necessary. 
(Loosen set screw on 80 column printer; user release mechanism on 132 column 
printer.) Tighten tractor after adjustment. 

e. Open spring loaded pressure plates on both tractors. 
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f. Load paper so that the two red arrows point to a perforation. Paper should lie 
smoothly between tractors without wrinkling or tearing the feed holes. 

g. Close spring-loaded pressure plates on both tractors. 

h. Adjust COPIES CONTROL lever to proper number of copies to be made, if necessary. 
Set to 1 or 2 for single forms, set to 5 or 6 for six-part forms. 

i. Close drum gate and lock in position with drum gate latch. After 1,0 seconds the 
READY indicator should light. 

j. Lift TOP OF FORM switch several times to ensure paper is feeding properly. 

k. Set printer to on line. ON LINE indicator should light. At this point printed 
matter can be aligned with the paper lines, if desired, by rotating the paper 
vertical adjustment knob. 



5.5 TC11AU5S DECTAPE CONTRO L AND TRA NSPORT 

DECtape units are available on most RSTS-11 systems. DECtape serves as an auxiliary 
magnetic tape storage facility to the system disk(s). 

A DECtape peripheral unit consists of three components: 

a. TU55 DECtape transport, pictured in Figure 5-7, which reads and/or writes infor- 
mation on magnetic tape. 

b. TCI 1 Controller, the interface which controls information transfer. One controller 
serves up to four transports (up to 8 tape drives). The Controller is transparent to 
the RSTS-11 user. 

c. DECtape , the recording medium used for data storage, consists of reel mounted 
magnetic tape formatted to permit read/write operations in either direction, error 
checking, block identification, and timing control. 




Figure 5-7 TU56 DECtape Transport 
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DECtape stores and retrieves information at fixed positions on magnetic tape. The advan- 
tage of DECtape over conventional magnetic tape is that information at fixed positions can be 
addressed. Conventional magnetic tape stores information in sequential (not addressable direct- 
ly), variable-length positions. DECtape incorporates timing and mark information to reference 
the fixed positions. The ten-channel DECtape records five channels of information: a timing 
channel, a mark channel, and three information channels. These five channels are duplicated 
on the five channels remaining to minimize any possibility of information loss from the other 
channels. 

Each formatted (certified) DECtape contains 578 blocks of data consisting of 256 (16-bit) 
PDP-11 words per block. 562 blocks are available to the user on each DECtape (several blocks 
are used for file directories). 

Tape movement can be controlled by programmed instructions from the computer (i.e., 
through PIP) or by manual operation of switches located on the front panel of the transport. 
Data is transferred only under program control. The transport controls and lights are described 
in Table 5-3. 



Table 5-3 
DECtape Controls 



Light/Switch 


Function 


REMOTE/OFF/LOCAL 


This three-position rocker switch determines control of the 
DECtape unit. 




REMOTE enables computer control of the transport unit. 




OFF disables the transport unit. 




LOCAL places the transport unit under operator control 
from the external transport switches. 


FORWARD/REVERSE 


This two-position rocker switch enables manual winding of tape 
when transport unit is under LOCAL control. 




FORWARD causes tape to feed onto right-haid spool. 




REVERSE causes taps to feed onto left-hand spool. 


Unit selector 


The value specified by this eight-position rotary switch identi- 
fies the transport to the computer. A unit selecto- value of 1 
allows the tape on that unit to be accessed as device DTI: 
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Table 5-3 (cont'd.) 



Lig'il/Switch Function 



WRITE ENABLE/WRITE LOCK This two-position rocker switch determines whether or not a 

tape can be written. Any tape can be searched and read; 
however when the WRITE LOCK switch is on, the tape is 
protected from accidental writing or program deletion. 

REMOTE light When lit, the tape unit is on-line. The tape unit is on-line 

when: 

a. REMOTE/OFF/LOCAL switch is in REMOTE position, and 

b. unit selector switch setting agrees with the DECtape unit 
currently being accessed. 

WRITE ENABLE light When lit, indicates that the WRITE ENABLE/WRITE LOCK switch 

is set to WRITE ENABLE, regardless of whether the REMOTE 
light is on or not. 



Operating procedures associated with DECtape units are described below. In order to 
mount a tape on a DECtape drive: 

a . Set the REMOTE/OFF/LOCAL switch to OFF . 

b. Place full DECtape reel on left spindle with label facing out. Press reel 
tightly onto spindle. 

c. Pull tape leader over the two tape guides and the magnetic head until it 
reaches the take-up reel on the right hand side of the tape unit. 

d. Wind loose tape end four turns around the empty right-hand reel by rotating 
right reel clockwise. 

e. Set REMOTE/OFF/LOCAL switch to LOCAL. Verify that power is available 
to the tape unit. 

f . Depress FORWARD/REVERSE switch in the FORWARD direction to wind about 
15 turns onto the right-hand reel. This ensures that the tape is securely 
mounted . 

In order to operate the DECtape unit on-line: 

a. Set the REMOTE/OFF/LOCAL switch to either LOCAL or OFF and be sure 
power is available to the system. 

b. Load the appropriate DECtape following the instructions above. 

c. If the DECtape write operation is to be inhibited (to protect tape from acci- 
dental damage), set WRITE ENABLE/WRITE LOCK switch to WRITE LOCK. 
If the write operation is desired on this tape, set switch to WRITE ENABLE. 
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d. Dial the correct unit number on the unit selector. (No two active DECtape 
units should have the same unit number.) 

e. Set REMOTE/OFF/LOCAL switch to REMOTE. Use of this DECtape unit is 
now under program control . 

f. When on-line operation of this unit is to cease, set REMOTE/OFF/ 
LOCAL switch to OFF or LOCAL. A moving tape can be stopped by quickly 
switching the REMOTE/OFF/LOCAL switch from REMOTE to LOCAL. The 
switch can be set to OFF when tape motion has stopped. 

To remove a DECtape from the tape unit: 

a. Set REMOTE/OFF/LOCAL switch to LOCAL. 

b. Depress and hold REVERSE switch until all tape is wound onto the left-hand 
tape reel. 

c. Set REMOTE/OFF/LOCAL switch to OFF. 

d. Remove full reel from left-hand spindle. 

5.6 TMIVTUIO MAGTAPE CONTROL AND TRANSPORT 

Magtape is an optional addition to a RSTS-11 system. Magtape is used to provide storage 
for large volumes of data and programs. Writing , reading, and search operations are performed 
in a serial manner. Transfer of information can be made between RSTS-11 and other computer 
systems because the TU10 Controller reads and writes information in an industry-compatible 
format. 

The basic DECmagtape system consists of three components: 

a. TU10 Tape Transport, pictured in Figure 5-8, can read or write information 
on magnetic tape in nine channels (on RSTS-11, with a choice of 7 or 9 
channels in other applications). 

b. TM11 Controller is an interface between the tape transport units and the 
RSTS-11 system (unibus). One Controller serves up to eight transport units. 
The Controller is transparent to the RSTS-11 user. 

c. Magnetic Tape, the recording medium used for data storage, consists of reel- 
mounted magnetic tape formatted in 9-channel industry-compatible format. 
Tape includes end-of-tape (EOT) and beginning-of-tape (BOT) reflective 
(silver) markers, record gaps, lateral and longitudinal parity characters, and 
file marks, with a cyclic redundancy check character. 
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Figure 5-8 TU10 DEC Magnetic Tape System 

Transfer rate is up to 36,000 characters per second. Ten and one half inch magtape reels 
permit up to 24,00 feet of tape per reel. Rewind time for a reel of 24,00 feet is approximately 
3 minutes, end to end. 

5.6.1 Magtape Control Panel 

The TU10 magtape transport control panel is shown in Figure 5-9. This panel is located 
at the lower left of the TU10 front panel shown in Figure 5-8. Table 5-4 describes the tape 
transport controls and Table 5-5 describes the various tape transport indicators. 



LINE SElIIwRtII FWoIIbEV REW 



"OFF OFF-LINE STOP 

LOAD FWD 









REW 






□ 






BR REL 


SELECT 




REV 



Figure 5-9 TU1J0 Control Panel 
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Switch 



PWRON/PWROFF 
ON-LINE/OFF-LINE 



START/STOP 
LOAD/BR REL 

UNIT SELECT 

FWD/REW/REV 



Table 5-4 
Magtape Transport Controls 



Function 



This two-position switch applies power to the transport unit. 

This two-position switch controls operation of the transport unit. 
ON-LINE allows system operation under program control. OFF- 
LINE allows manual operation. Tape unit cannot be remotely 
selected when switch is in OFF-LINE position. Setting to OFF- 
LINE causes tape to wind to BOT marker. 

This two-position switch controls starting and stopping of tape 
motion. STOP does not stop transport during a rewind operation. 

This three-position switch energizes the vacuum system in the 
LOAD position (necessary for any operation). The BR REL posi- 
tion releases vacuum tension and allows reels to be manually 
rotated. Center position locks reel brakes. 

This eight-position rotary switch identifies the transport to the 
computer. A unit select value of 1 allows the tape on that unit 
to be accessed as device MT1: No two transports should be set 
to the same number. 

This three-position switch moves the tape in the selected direc- 
tion,, depending on activation of the START/STOP switch. FWD 
moves tape forward until EOT marker is sensed. REW rewinds 
tape onto the feed reel until BOT marker is sensed; depressing the 
switch again causes the tape to completely rewind . REV rewinds 
tape until BOT marker is sensed. 



Light 



Table 5-5 
Magtape Transport Indicators 



Function 



PWR light 
(power) 

LOAD light 



RDY light 
(ready) 

LD FT light 
(load point) 

END FT light 
(end point) 



When lit, indicates that power is available to the transport unit. 



When lit, indicates that vacuum system has been enabled, 
allowing either on-line or off-line commands. 

When lit, indicates that all I/O lines are enabled. Transport 
can accept processor commands provided SEL light is also lit. 

When lit, indicates that BOT marker has been sensed; transport 
ready for operation . 

When lit, indicates that EOT marker has been sensed; all tape 
motion stops to prevent tape from winding off reel . 
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Table 5-5 (cont'd.) 



Light 


Function 


FILE PROT light 
(file protection) 


When lit, indicates that writing on the tape is inhibited. This 
is true if no file reel is mounted on feed reel hub or if a file 
reel is mounted without a write enable ring. 


OFF-LINE light 


When lit, indicates that transport can be operated manually 
and cannot be operated under program control . 


SEL light 
(select) 


When lit, indicates that transport has been selected and is 
completely on-line. Transport can read or write data. 


WRT light 
(write) 


When lit, indicates that write-enable ring has been installed 
on feed reel and transport can write on tape. 


FWD light 
(forward^ 


When lit, indicates tape is moving in forward direction. 


REV light 


When lit, indicates that tape is moving in reverse direction. 


(reverse) 




REW light 
(rewind) 


When lit, indicates that tape is being rewound; Tape continues 
until BOT marker is sensed. 



5.6.2 Magtape Operating Procedures 

Whenever handling magnetic tapes and reels, it is important to observe the following 
precautions to prevent loss of data and/or damage to tape handling equipment: 

a. Handle a tape reel by the hub hole only. Squeezing reel flanges can damage 
tape edges when winding or unwinding tape. 

b. Never touch tape between BOT and EOT markers. Do not allow end of tape 
to drag on floor. 

c. Never use a contaminated reel of tape; this spreads dirt to clean tape reels 
and can affect transport operation . 

d. Always store tape reels inside containers. Keep empty containers closed so 
dust and dirt cannot collect. 



f. 



Inspect tapes, reels, and containers for dust and dirt. Replace old or 
damaged take-up reels. 

Do not smoke near transport or tape storage area. Smoke and ash are 
especially damaging to tape. 
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g. Do not place transport near a line printer or other device that produces 
paper dust. 

h. Clean tape path frequently. 

To mount a tape reel on the magtape transport: 

a. Apply power to the transport by depressing the PWR ON switch. Ensure 
that the LOAD/BR REL switch is in the center position. Transport is ON- 
LINE. 

b. Place a write-enable ring in the groove on the file reel if data is to be 
written on the tape. If writing is not required, be sure there is no ring 
in the groove. 

c. Mount file reel onto lower hub with groove facing toward the back. Press 
reel tightly onto spindle; tighten center nut. 

d. Install take-up reel (top reel), if necessary, as described in (c) above. The 
top reel is generally permanent and should not require installation by the user. 

e. Place LOAD/BR REL switch to the BR REL position. 



f . Unwind tape from the file reel and thread tape over tape guides and head 
assembly as shown in Figure 5-8. Wind about five turns of tape onto 
take-up reel . 

g. Set LOAD/BR REL switch to LOAD position to draw tape into vacuum 
columns. 

h. Select FWD and depress the START switch to advance the tape to the load 
point. When BOT marker is sensed, tape motion stops, the FWD indicator 
goes out and the LOAD PT indicator comes on. 

If tape motion continues for more than 10 seconds, depress STOP, select 
REV, and then depress START. The tape will advance to the BOT marker 
before stopping. (This may be necessary if, in winding the tape manually, 
the BOT marker has already been passed.) 

Setting the ON-LINE/OFF-LINE switch to ON-LINE allows the transport to accept commands 
from the controller under program control. The transport is not fully on-line until the RDY and 
SEL indicators are lit. 

To remove a tape from the transport unit: 

a. Set ON-LINE/OFF-LINE switch to OFF-LINE position. 

b. Set START/STOP switch to STOP position. 

c. Set FWD/REW/REV switch to REW position. 
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d. Set START/STOP switch to START position Taps rewinds until BOT 
marker is reached. 

e. Set LOAD/BR REL switch to BR REL position to release brakes. 

f . Gently hand wind the file reel in a counter clockwise direction until all of 
the tape is wound onto the reel . Do not jerk the reel . This may stretch or 
compress the tape which can damage data. 

g. Remove the file reel from the hub assembly. 
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APPENDIX A 
BASIC -PLUS LANGUAGE SUMMARY 

All manual section numbers given in this Appendix refer to sections in 
The BASIC-PLUS Language Manual . 



A.l SUMMARY OF VARIABLE TYPES 



Type 
Floating Point 

Integer 

Character String 

Floating Point 
Matrix 

Integer Matrix 



Character String 
Matrix 



Variable Name 

single letter 
optionally followed by a 
single digit 

any floating point variable 
name followed by a % character 

any floating point variable 
name followed by a $ character 

any floating point variable 
name followed by one or two 
dimension elements in 
parentheses 

any integer variable name 
followed by one or two dimen- 
sion elements in parentheses 

any character string variable 
name followed by one or two 
dimension elements in paren- 
theses 



A. 2 SUMMARY OF OPERATORS 

T YP e 

Arithmetic 

t 

*,/ 
+ ,- 



Ooerator 



Relational 



Logical 



String 



Matrix 



< 

< = 
> 
>= 

< > 

NOT 

AND 

OR 

XOR 

IMP 

EQV 

+ 



+ ," 



unary minus 
exponentiation 
multiplication, division 
addition, subtraction 

equals 

less than 

less than or equal to 

greater than 

greater than or equal to 

not equal to 

approximately equal to 

logical negation 
logical product 
logical sum 
logical exclusive or 
logical implication 
logical equivalence 

concatenation 



addition and subtraction 
of matrices of equal dimen- 
sions, one operator per 
statement 

multiplication of con- 
formable matrices 
scalar multiplication of 
a matrix 



Examples 


A 
I 
X3 




B% 

D7% 




M$ 
Rl$ 




S(4) 
N2(8) 


E(5,l) 
V8(3,3) 


A%(2) 
E3% (4) 


I%(3,5) 
R2% (2,1) 



C$(l) S$(8,5) 
A2$(8) Vl$(4,2) 



Operates Upon 

numeric variables 
and constants 



string or 
numeric variables 
and constants 

== undefined 
for strings 

relational ex- 
pressions composed 
of string or 
numeric elements 
with relational 
operators 

string constants 
and variables 

dimensioned vari- 
ables. See Sec- 
tion 7.6.1 for 
further details. 
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A. 3 SUMMARY OF FUNCTIONS 

Under the Function column, the function is shown as: 

Y=function 

where the characters % and $ are appended to Y if the value returned 
is an integer or character string. 

A floating value (X) , where specified, can always be replaced 
by an integer value. An integer value (N%) can always be replaced 
by a floating value (an implied FIX is done) except in the CVT%$ 
and MAGTAPE functions (the symbol 1% is used to indicate the neces- 
sity for an integer value) . 

Section numbers found in the Explanation column refer to sections 
in the BASIC-PLUS Language Manual. 



Type 
Mathematical 



Print 



String 



Function 

Y=ABS(X) 
Y=ATN (X) 
Y=COS (X) 
Y=EXP (X) 
Y=FIX(X) 

Y=INT(X) 

Y=LOG (X) 

Y=LOG10 (X) 

Y=PI 

Y=RND 

Y=RND(X) 

Y=SGN(X) 

Y=SIN(X) 
Y=SQR(X) 
Y=TAN(X) 

Y%=POS(X%) 



Y$=TAB(X%) 

Y%=ASCII(A$) 
Y$=CHR$(X%) 

Y$=CVT%$ (1%) 
Y$=CVTF$ (X) 
Y%=CVT$%(A$) 
Y=CVT$F(A$) 



Explanation 

returns the absolute value of X, 
returns the arctangent of X in radians, 
returns the cosine of X in radians 
returns the value of e+X, where e=2. 71828. 
returns the truncated value of X, 

SGN(X)*INT(ABS(X)) 
returns the greatest integer in X which 

is less than or equal to X . 
returns the natural logarithm of X, log e X, 
returns the common logarithm of X, log-^X , 
has a constant value of 3.14159. 
returns a random number between and 1, 
returns a random number between and 1. 
returns the sign function of X, a value 

of 1 preceded by the sign of X, 
returns the sine of X in radians, 
returns the square root of X, 
returns the tangent of X in radians. 

returns the current position of the print 
head for I/O channel X, is the user s 
Teletype. (This value is imaginary for 
disk files.) 

moves print head to position X in the cur- 
rent print record, or is disregarded if 
the current position is beyond X. The 
first position is counted as fl.) 

returns the ASCII value of the first char- 
acter in the string A$. 
returns a character string having the 

ASCII value of X. Only one character 

is generated, 
maps integer into 2-character string, see 

Section 11.5. 
maps floating-point number into 4- or 8- 

character string, see Section H- = . 
maps first 2 characters of string A$ into 

an integer, see Section 11.5. 
maps first 4 or 8 characters of string A$ 

into a floatinq-point number. See Sec 

tion 11.5. 
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Type 



Function 



Explanation 



String, 
cont'd. 



Y$=LEFT(A$,N%) 
Y$=RIGHT(A$,N%) 

Y$=MID(A$,N1%,N2%) 

Y%=LEN(A$) 
Y%=INSTR(N1% , A$ ,B$) 



Y$=SPACE$(N%) 
Y$=NUM$ (N%) 



Y=VAL(A$) 



Y$=XLATE(A$,B$) 



returns a substring of the string A$ 
from the first character to the Nth 
character (the leftmost N characters) . 

returns a substring of the string A$ 
from the Nth to the last character; 
the rightmost characters of the string 
starting with the Nth character. 

returns a substring of the string A$ 
starting with the Nl and being N2 
characters long (the characters 
between and including the Nl 
to N1+N2-1 characters) . 

returns the number of characters in the 
string A$ , including trailing blanks. 

indicates a search for the substring 
B$ within the string A$ beginning at 
character position Nl. Returns a 
value if B$ is not in A$ , and the 
character position of B$ if B$ is 
found to be in A$ (character posi- 
tion is measured from the start of 
the string) . 

indicates a string of N spaces, used 
to insert spaces within a character 
string. 

indicates a string of numeric charac- 
ters representing the value of N as 
it would be output by a PRINT state- 
ment. For example: NUM$ {1.0000) = 
(space) 1 (space) and NUM$ (-1.0000) = 
-1 (space) . 

computes the numeric value of the 
string of numeric characters A$. 
If A$ contains any character not 
acceptable as numeric input with 
the INPUT statement, an error re- 
sults. For example: 

VAL("15")=15 

translate A$ to the new string Y$ 
by means of the table string B$, 
see Section 11.7. 



System 



Y$=DATE$(0%) 



Y$=DATE$(N%) 



Y$=TIME$(0%; 



returns the current date in the fol- 
lowing format : 

02 -Mar- 71 

returns a character string correspond- 
to a calendar date as follows: 
N=(day of year) +[ (number of 
years since 1970)*1000] 

DATE$(1) = "01-Jan-70" 
DATE$(240) = "05-May-70" 

returns the current time of day as a 
character string as follows: 

TIME$ (0) = "05:30 PM" 
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Type 



Function 



Explanation 



Y$=TIME$(N%) 



Y=TIME(0%) 
Y=TIME(1%) 
Y=TIME(2%) 

Y%=ERR 

Y%=ERL 

Y%=SWAP% (N%) 
Y$=RAD$ (N%) 



MAT Y=TRN(X) 
MAT Y=INV(X) 
Y=DET 

Y%=NUM 

Y%=NUM2 



returns a string corresponding to the 
time at N minutes before midnight, 
for example: 

TIME$(1) = "11:59 PM" 
TIME$(1440) = "12:00 AM" 
TIME$(721) = "11:59 AM" 

returns the clock time in seconds since 
midnight, as a floating point number. 

returns the central processor time used 
by the current job in tenths of seconds, 

returns the connect time (during which 
the user is logged into the system) 
for the current job in minutes. 

returns value associated with the last 
encountered error if an ON ERROR GOTO 
statement appears in the program. 
See Section 8.4. 

returns the line number at which the 
last error occurred if an ON ERROR 
GOTO statement appears in the pro- 
gram. See Section 8.4.3. 

causes a byte swap operation on the 
two bytes in the integer variable N%. 

converts an integer value to a 3- 

character string and is used to con- 
vert from Radix- 50 format back to 
ASCII. See Appendix D. 



Matrix MAT Y=TRN(X) returns the transpose of the matrix X, 

see Section 7.6.2. 

returns the inverse of the matrix X, 
see Section 7.6.2. 

following an INV(X) function evaluation, 
the variable DET is equivalent to the 
determinant of X. 

following input of a matrix, NUM con- 
tains the number of elements entered 
in the last row. 

following input of a matrix, NUM2 con- 
tains the number of rows input. 

Magtape Y%=MAGTAPE (11%, 12% ,13%) 

provides program control over magtape 
operations by means of several func- 
tion specifications. See Section 
12.3.7. 



Y%=RECOUNT 



returns the number of characters read 
following every input operation. 
Used primarily with non-file struc- 
tured devices. See Section 11.3.1. 
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A. 4 SUMMARY OF BASIC-PLUS STATEMENTS 

The following summary of statements available in the BASIC-PLUS 
language defines the general format for the statement as a line in a 
BASIC program. If more detailed information is needed, the reader is 
referred to the section (s) in the BASIC-PLUS Language Manual dealing 
with that particular statement. 

NOTE: All section numbers refer to the BASIC-PLUS Language Manual . 

In these definitions, elements in angle brackets are necessary 
elements of the statement. Elements in square brackets are necessary 
elements of which the statement may contain one. Elements in braces 
are optional elements of the statement. 

Where the term line number ({line number}) is shown in braces, 
this statement can be used in immediate mode. 

The various elements and their abbreviations are described below: 

variable or var Any legal BASIC variable as described in A.l 

or Section 2.5.2. 

line number Any legal BASIC line number described in 

Section 2.2. 

expression or ezp Any legal BASIC expression as described in 

Section 2.5. 

message Any combination of characters. 

condition or oond Any logical condition as described in Sec- 
tion 3.5. 

constant Any acceptable integer constant (need not 

contain a % character) . 

argument (s) or arg Dummy variable names. 

statement Any legal BASIC-PLUS statement. 

string Any legal string constant or variable as 

described in Section 5.1. 

protection Any legal protection code as described in 

Section 9.1. 

value (s) Any floating point, integer, or character 

string constant. 

list The legal list for that particular statement. 

dimens-ion(s) One or two dimensions of a matrix, the maxi- 

mum dimension (s) for that particular state- 
ment. 
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BASIC-PLUS Language 
Statement Formats and Examples Manual Section 

REM 

{line number} REM <me88age> 3.1 

Kline number} {< at at ement>] I <message> 

10 REM THIS IS A COMMENT 

15 PRINT ! PERFORM A CR/LF 

LET 

{line number} {1.E1} <var>{ ,<var> ,<var> . . . } = <exp> 3.2 

55 LET A=40: B=22 
60 B,C,A=4.2 IMULTIPLE ASSIGNMENT 

DIM 

line number DIM<var(dimeneion(s))> 3.6.2 

10 DIM A (20), B$(5,10), C%(45) 7.1 

line number DIM # <aonstant> , <var (dimension (s) ) >=<constant>9 . 6 . 1 
75 DIM #4, A$(100)=32,B(50,50) 9.6.2 

RANDOMIZE 3.7.2 

line number RANDOM{IZE} 

55 RANDOMIZE 

70 RANDOM 
IF-THEN, IF-GOTO 

line number IF <aond> I THEN<Z£ne number>\ 3.5 



f~THEN<statement> ~\ 
I THEN<Z£ne number>\ 
[_GOTO<line number>_J 
55 IF A?B OR B>C THEN PRINT "NO" 
60 IF FNA(R)= B THEN 250 
95 IF L<X+2 AND L<>0 GOTO 345 



IF-THEN-ELSE -v Q 5 

line number IF <oond> I THEN<Zine number> 



[TEET<l<statement> 
THEN<Z-ine number> f ELSE<stateme« t> 1 
GOTO<Ziwe number> \ El,SE<line number> j 



30 IF B=A THEN PRINT "EQUAL" ELSE PRINT "NOT EQUAL" 

50 IF A>N THEN 200 ELSE PRINT A 

75 IF B==R THEN STOP ELSE 80 

FOR 

line number FOR <var>= <exp>TO <exp> {STEP<ea;p>} 3.6.1 

20 FOR 1=2 TO 40 STEP 2 

55 FOR N=A TO A+R 

FOR-WHILE, FOR- UNTIL fwHILEl 8 ' 6 

line number FOR <var> = <exp> {STEP<exp>} UNTIL <aond> 

84 FOR 1 = 1 STEP 3 WHILE KX 

74 FOR N = 2 STEP 4 UNTIL N>A OR N=B 

05 FOR B= 1 UNTIL B>10 

NEXT 3.6.1 

line number NEXT <var> 

25 NEXT I 

60 NEXT N 
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BASIC-PLUS Language 
Statement Formats and Examples Manual Section 



DEF, single line 3.7.3 

line number DEF FN<var> (arg) =<exp (arg )> 5.5.1 

20 DEF FNA(X,Y,Z)=SQR(X+2+Yt2+Z+2) 6.4 

DEF, multiple line 

line number DEF FN<yar> (arg ) 8.1 

<statements> 
line number FN<var>=<exp> 
line number FNEND 

10 DEF FNF(M) ! FACTORIAL FUNCTION 

20 IF M=l THEN FNF=1 ELSE FNF=M*FNF (M-l) 

30 FNEND 

GOTO 3.4 

line number GOTO <line number> 
100 GOTO 50 

ON-GOTO 

line number ON <exp> GOTO <list of line numbers> 8.2 

75 ON X GOTO 95, 150, 45, 200 

GOSUB 

line number GOSUB <line number> 3.8.1 

90 GOSUB 200 

ON -GO SUB 

line number ON <exp> GOSUB <list of line numbers> 8.3 

85 ON FNA(M) GOSUB 200, 250, 400, 375 

RETURN 

line number RETURN 3.8.2 

375 RETURN 

CHANGE 5.2 

{line number} CHANGE [<«**«■» name>~\ TQ C<string var>-} 

^<strzng var>J L<array name>- J 

25 CHANGE A$ TO X 
70 CHANGE M TO R$ 
75 CHANGE B TO B$ 

OPEN 9.2 

{line number} OVEH<string> ^ for (^utPUtJ ^ AS FILE <ex P > 9*2? 

{ , RECORDSI ZE<exp > } { , CLUSTERSI ZE <exp > } { , MODE < exp > } 
10 OPEN "PP:" FOR OUTPUT AS FILE Bl 9.6.3 

20 OPEN "FOO" AS FILE 3 

30 OPEN "DT4:DATA.TR" FOR INPUT AS FILE 10 
CLOSE w 9.5 

Xline number} CLOSE <list of exp> 11.2 

100 CLOSE 2 

255 CLOSE 10, 4, Nl 

3.3.1 
READ 5.3 

line number READ <list of variables> 6.3 

25 READ A, B$ , C%, Fl, R2 , B(25) 10.1 
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BASIC-PLUS Language 

Statement Formats and Examples Manual Section 

DATA 3.3.1 

line number DATA <list of valu.ee> 5.3 

300 DATA 4.3, "STRING" , 85 , 49 , 75 .04 , 10 6.3 

RESTORE 3.3.1 

line number RESTORE 10.2 

125 RESTORE 

PRINT 3.3.2 

5.4 

{line number} PRINT{ { #<exp> , } < lis t> } 6.3 

25 PRINT ! GENERATES CR/LF 9.2.3 

75 PRINT "BEGINNING OF OUTPUT" ; I ,A*I 9.3 

45 PRINT #4, "OUTPUT TO DEVICE"FNM (A) 1 2 ; B; A 10.4 

PRINT USING 

' {line number) PRINT { #<exp>, }USING <string>, <list> 10.4 

54 PRINT USING "##.##", A 

55 PRINT #3, USING"W###.## \\## M + + " , " A=", A, "B=" ,B 

56 PRINT #7, USING B$,A,B,C 

INPUT 3.3.3 

"{line number) INPUT {#<exp>_, }< lis t> 5.3 

25 INPUT "TYPE YOUR NAME " ,A$ 6.3 

55 INPUT #8, A, N, B$ 9.2.3 

9.2.5 
9.4 

INPUT LINE 5 ' 3 

{line number} INPUT LINE {%<exp>,} <string> 10 ■ 3 

40 INPUT LINE R$ 

75 INPUT LINE #1, E$ 

NAME-AS 9-7 

{line number) NAME <string> AS <string> 

455 NAME "NONAME" AS "FILEl<48>" 

270 NAME "DT4:MATRIX" AS "MATA1<48>" 



KILL 

{line number) KILL <string> 
45 KILL "NONAME" 



9.8 



ON ERROR GOTO 8 * 4 

line number ON ERROR GOTO {<line number>) 

10 ON ERROR GOTO 500 

525 ON ERROR GOTO 'DISABLES ERROR ROUTINE 

526 ON ERROR GOTO ! DISABLES ERROR ROUTINE 

8 4 1 
RESUME o.i.x 

line number RESUME {< line number>) 

1000 RESUME !OR RESUME ARE EQUIVALENT 

655 RESUME 200 

CHAIN 

line number CHAIN <string> {<line number>) 9 * 9 

375 CHAIN "PROG2.BAC" 

500 CHAIN "PROG3.BAC" 75 
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STOP 

line number STOP 
75 STOP 

END 

line number END 
545 END 

Matrix Statements 

MAT READ 



3.9 



3.9 



line number MAT READ <list of matrioes> 
55 DIM A (20), B$(32), C% (15, 1(f) 
90 MAT READ A, B$(25), C% 

MAT PRINT 

{line number) MAT PRINT{ #<exp> , } <matrix name> 

10 DIM A (20) , B (15,20) 

90 MAT PRINT A; ! PRINT 10*10 MATRIX, PACKED 

95 MAT PRINT B(10,5), 1PRINT 10*5 MATRIX, FIVE 

! ELEMENTS PER LINE 

97 MAT PRINT #2, A; ! PRINT ON OUTPUT CHANNEL 2 

MAT INPUT 

{line number} MAT INPUT{ #<exp>, } <list of matriaes> 
10 DIM B$(40) , Fl%(35) 

20 OPEN "DT3:FOO" FOR INPUT AS FILE 3 
30 MAT INPUT #3, B4, Fl% 



7.2 



7.3 



7.4 



MAT Initialization 

fZER 
{line number] MAT <matrix name>= 



7.5 



{dimension (s ) } 



CON 
UDN. 
10 DIM B(15,10), A(10), c%(5) 

15 MAT C% = CON !ALL ELEMENTS OF C%(I)=1 

20 MAT B = IDN(10,10) ! IDENTITY MATRIX 10*10 
95 MAT B = ZER(N,M) "CLEARS AN N BY M MATRIX 

Statement Modifiers (can be used in immediate mode) 

IF 

<statement> IF <oondition> 

10 PRINT X IF X<>0 

UNLESS 

<statement> UNLESS <aondition> 8 7 2 

45 PRINT A UNLESS A=0 



8.7.1 



FOR 

<statement> FOR <var> = <exp> TO <exp>{STEP<exp> } 
75 LET B$(I) = "PDP-11" FOR I = 1 TO 25 
80 READ A (I) FOR 1=2 TO 8 STEP 2 



WHILE 



<statement> WHILE <condition> 

10 LET A(I) = FNX(I) WHILE K45.5 



8.7.3 



8.7.4 
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BASIC-PLUS Language 
Manual Section 

UNTIL 8.7.5 

<statement> UNTIL <aondition> 

115 IF B THEN A(I)=B UNTIL I>5 

System statements 

<line number> SLEEP <expr>ession> 8.8 

10J3 SLEEP (20) 1DISMISS JOB FOR 20 SEC. 

<line number> WAIT <expression> 8.8 

525 WAIT(A%+5) 1WAIT A%+5 SEC. FOR INPUT 



Record I/O Statements 

<line number> LSET<string var>{ 3 <string var>)=<string> 11.4.2 

90 LSET B$="XYZ" 

<lin& number> RSET<string var>{ ,<string var>}=<string> 11.4.2 

250 RSET C$="67890" 

<line number> FIELD#<expr>,<expr>AS<string var>{ > <expr>AS<string Var>] 

75 FIELD! 2%, 10% AS A$ , 20% AS B$ 11.4.1 

<line number> GET#<expr >{ , RECORD<ea:pr>} 11.3 

100 GET#1%, RECORD 99% 

<line number> PUT#<expr>{ ,RECORD<expr> }{ J COUNT<ea;pr>} 11.3 

500 PUT* 1%, COUNT 80% 

<line number> UNLOCK#<expr> 12.2 

100 UNLOCK #3% 
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BASIC-PLUS COMMAND SUMMARY 



Command 



Explanation 



Section in 
RSTS-11 
System User's Guide 



ASSIGN Used to reserve an I/O device for the use of 

the individual issuing the command. The speci- 
fied device can then be given commands only 
from the terminal which issued the ASSIGN. 



2.6.3 



BYE 



CAT 
CATALOG 



COMPILE 



CONT 



Indicates to RSTS that a user wishes to leave 
the terminal. Closes and saves any files re- 
maining open for that user. 

Returns the user's file directory. Unless an- 
other device is specified following the term 
CAT or CATALOG, the disk is the assumed device. 

Allows the user to store a compiled version of 
his BASIC program. The file is stored on disk 
with the current name and the extension .BAC. 
Or, a new file name can be indicated and the 
extension .BAC will still be appended. 

Allows the user to continue execution of the 
program currently in core following the execu- 
tion of a STOP statement. 



2.1.3 



2.5.2 



2.3.3 



2.2. 



DEASSIGN Used to release the specified device for use 
by others. If no particular device is speci- 
fied, all devices assigned to that terminal 
are released. An automatic DEASSIGN is per- 
formed when the BYE command is given. 

DELETE Allows the user to remove one or more lines 

from the program currently in core. Following 
the word DELETE the user types the line number 
of the single line to be deleted or two line 
numbers separated by a dash (-) indicating the 
first and last line of the section of code to 
be removed. Several single lines or line 
sections can be indicated by separating the 
line numbers, or line number pairs, with a 
comma. 



2.6.4 



2.2.5 



HELLO 



KEY 



Indicates to RSTS that a user wishes to log 
onto the system. Allows the user to input 
project-programmer number and password. 

Used to re-enable the echo feature on the user 
terminal following the issue of a TAPE command. 
Enter with LINE FEED or ESCAPE key. 



2.1.2 



2.6.2 
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Command 



LENGTH 



LIST 



LISTNH 



Explanation 

Returns the length of the user's current 
program in core, in IK increments. 



Section in 
RSTS-11 
System User's Guide 



Allows the user to obtain a printed listing 
at the user terminal of the program currently 
in core, or one or more lines of that program. 
The word LIST by itself will cause the list- 
ing of the entire user program. LIST followed 
by one line number will list that line; and 
LIST followed by two line numbers separated 
by a dash (-) will list the lines between and 
including the lines indicated. Several single 
lines or line sections can be indicated by 
separating the line numbers , or line number 
pairs, with a comma. 

Same as LIST, but does not print header con- 
taining the program name and current date . 



2.5.1 



2.2.4 



2.2.4 



NEW 



OLD 



RENAME 



REPLACE 



RUN 



Clears the user's area in core and allows the 2.2.1 
user to input a new program from the terminal. 
A program name can be indicated following the 
word NEW or when the system requests it. 

Clears the user's area in core and allows the 2.4.2 
user to recall a saved program from a storage 
device. The user can indicate a program name 
following the word OLD or when the system re- 
quests it. If no device name is given, the 
file is assumed to be on the system disk. A 
device specification without a filename will 
cause a program to be read from an input-only 
device (such as high-speed reader, card reader) . 

Causes the name of the program currently in 2.2.6 
core to be changed to the name specified after 
the word RENAME. 

Same as SAVE, but allows the user to substitute 2.4.6 
a new program with the same name for an old pro- 
gram, erasing the old program. 

Allows the user to begin execution of the pro- 2.3.1 
gram currently in core. The word RUN can be fol- 
lowed by a file name in which case the file is 
loaded from the system disk, compiled, and run; 
alternatively, the device and file name can be 
indicated if the file is not on the system disk. 
A device specification without a file name will 
cause a program to be read from an input only 
device (such as high-speed reader, card reader). 



RUNNH 



Same as RUN, but does not print header contain- 
ing the program name and current date. 



2.3.1 
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Command 



SAVE 



Explanation 



Section in 

RSTS-11 

System User's Guide 



Causes the program currently in core to be 
saved on the system disk under its current 
file name with the extension .BAS. Where 
the word SAVE is followed by a file name or 
a device and a file name, the program in core 
is saved under the name given and on the de- 
vice specified. A device specification with- 
out a file name will cause the program to be 
output to any output only device (line printer, 
high-speed punch) . 



2.4.1 



TAPE Used to disable the echo feature on the user 2.6.1 
terminal while reading paper tape via the 
low-speed reader. 

UNSAVE The word UNSAVE is followed by the file name 2.4.5 
and, optionally, the extension of the file to 
be removed. The UNSAVE command cannot remove 
files without an extension. If no extension 
is specified, the source (.BAS) file is deleted. 
If no device is specified, the disk is assumed. 

Special Control Character Summary 

CTRL/C Causes the system to return to BASIC command 3.5 
mode to allow for issuing of further commands 
or editing. Echoes on terminal as iC. 

CTRL/0 Used as a switch to suppress/enable output of 3.7 
a program on the user terminal. Echoes as to. 

CTRL/U Deletes the current typed line, echoes as +U 3.6 
and performs a carriage return/line feed. 

CTRL/Z Used as an end-of-file character. 3.9 

ESCape or Enters a typed line to the system, echoes on 3.2 
ALT MODE the user terminal as a $ character and does 
Key not cause a carriage return/line feed. 

LINE FEED Used to continue the current logical line on 3.3 
Key an additional physical line. Performs a 
carriage return/line feed operation. 

RETURN Enters a typed line to the system, results in a 3.1 
Key carriage return/line feed operation at the user 
terminal. 

RUBOUT Deletes the last character typed on that physi- 3.4 
Key cal line. Erased characters are shown on the 
teleprinter between back slashes. 

TAB or Performs a tabulation to the next of nine tab 3.8 
CTRL/I stops (eight spaces apart) which form the 
terminal printing line. 
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ERROR MESSAGE SUMMARY 



Wherever possible, RSTS follows an error message with the phrase 

AT LINE xxxx 

where xxxx is the line number of the statement which caused the error. 
For example: 



10 TALK 

ILLEGAL VERB AT LINE 10 

READY 



The additional message is not printed when no line number can be as- 
sociated with the error. 

TALK 

WHAT? 

READY 

An (SPR) in the description of any error message in this Appendix 
indicates an error which should never be seen by a user. If such a 
message is received, the user should document how he obtained the error 
and file a Software Performance Report with DEC, including the perti- 
nent output. 

C.l USER RECOVERABLE ERRORS 

A (C) in the description of the error message indicates that pro- 
gram execution continues, following printing of the error message, 
if an ON ERROR GOTO statement is not present. Normally, execution 
terminates on an error condition, the error message is printed, and 
the system prints READY. The ERR column gives the value of the ERR 
variable (see Section 8.4 in the BASIC-PLUS Language Manual ) . 

ERR Message Printed Meaning 

1 BAD DIRECTORY FOR DEVICE The directory of the device refer- 
enced is an unreadable format or an 
attempt was made to perform a direc- 
tory oriented access to a non- 
directory device. 

C-l 



10 



11 



12 



13 



Message Printed 
ILLEGAL FILE NAME 



ACCOUNT OR DEVICE IN USE 



NO ROOM FOR USER ON DEVICE 



CAN'T FIND FILE OR ACCOUNT 



NOT A VALID DEVICE 



I/O CHANNEL ALREADY OPEN 



DEVICE NOT AVAILABLE 



I/O CHANNEL NOT OPEN 



PROTECTION VIOLATION 



END OF FILE ON DEVICE 



FATAL SYSTEM I/O FAILURE 



USER DATA ERROR ON DEVICE 



Meaning 

The filename specified is not accept- 
able. It contains unacceptable char- 
acters or the filename specification 
format has been violated. 

Removal or dismounting of the account 
or device cannot be done since one 
or more users are currently using it. 

Storage space allowed for the current 
user on the device specified has been 
used or the device as a whole is too 
full to accept further data. 

The file or account number specified 
was not found on the device specified. 

Attempt to use an illegal or nonexis- 
tent device specification. 

An attempt was made to open one of 
the twelve I/O channels which had 
already been opened by the program. 
(SPR) 

The device requested is currently 
reserved by another user. 

Attempt to perform I/O on one of the 
twelve channels which has not been 
previously opened in the program. 

The user was prohibited from perform- 
ing the requested operation because 
the kind of operation was illegal 
(such as input from a line printer) 
or because the user did not have the 
privileges necessary (such as delet- 
ing a protected file) . 

Attempt to perform input beyond the 
end of a data file. 

An I/O error has occurred on the sys- 
tem level. The user has no guarantee 
that the last operation has been 
performed. (SPR) 

One or more characters may have been 
transmitted incorrectly due to a par- 
ity error, bad punch combination on 
a card, or similar error. 



14 



DEVICE HUNG OR WRITE LOCKED User should check hardware condition 

of device requested. Possible causes 
of this error include a line printer 
out of paper or high-speed reader 
being off-line. 



15 



KEYBOARD WAIT EXHAUSTED 



Time requested by WAIT statement has 
been exhausted with no input received 
from the specified keyboard. 
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ERR Message Printed 

16 NAME OR ACCOUNT NOW EXISTS 



17 TOO MANY OPEN FILES ON UNIT 

18 ILLEGAL SYS ( ) USAGE 

19 DISK BLOCK IS INTERLOCKED 

2 PACK IDS DON'T MATCH 

21 DISK PACK IS NOT MOUNTED 

22 DISK PACK IS LOCKED OUT 

23 ILLEGAL CLUSTER SIZE 

24 DISK PACK IS PRIVATE 

25 DISK PACK NEEDS 'CLEANING' 

26 FATAL DISK PACK MOUNT ERROR 

27 I/O TO DETACHED KEYBOARD 

28 PROGRAMMABLE +C TRAP 

29 CORRUPTED FILE STRUCTURE 
30-41 not assigned 

42 VIRTUAL BUFFER TOO LARGE 

4 3 VIRTUAL ARRAY NOT ON DISK 



Meaning 

An attempt was made to rename a 
file with the name of a file which 
already exists, or an attempt was 
made by the system manager to in- 
sert an account number which is 
already within the system. 

Only one open DECtape output file 
is permitted per DECtape drive. 
Only one open file per magtape 
drive is permitted. 

Illegal use of the SYS system func- 
tion. 

The requested disk block segment 
is already in use (locked) by some 
other user. 

The identification code for the 
specified disk pack does not match 
the identification code already on 
the pack. 

No disk pack is mounted on the 
specified disk drive. 

The disk pack specified is mounted 
but temporarily disabled. 

The specified cluster size is unac- 
ceptable . 

The current user does not have ac- 
cess to the specified private disk 
pack. 

Non- fatal disk mounting error; use 
the CLEAN operation in UTILTY, 

Fatal disk mounting error. Disk can- 
not be successfully mounted. 

I/O was attempted to a hung up 

dataset or to the previous, but now 

detached, console keyboard for the 
job. 

ON ERROR-GOTO subroutine was entered 
through a program trapped CTRL/C. 
See a description of the SYS system 
function. 

Fatal error in CLEAN operation. 



Virtual core buffers must be 512 
bytes long. 

A non-disk device is open on the 
channel upon which the virtual ar- 
ray is referenced. 
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ERR 

44 

45 

46 

47 

48 



49 

50 
51 



52 
53 

54 

55 

56 
57 

58 



Message Printed 
MATRIX OR ARRAY TOO BIG 
VIRTUAL ARRAY NOT YET OPEN 

ILLEGAL I/O CHANNEL 

LINE TOO LONG 

FLOATING POINT ERROR 



ARGUMENT TOO LARGE IN EXP 

not assigned 
INTEGER ERROR 



ILLEGAL NUMBER 



ILLEGAL ARGUMENT IN LOG 



IMAGINARY SQUARE ROOTS 



SUBSCRIPT OUT OF RANGE 



CAN'T INVERT MATRIX 



OUT OF DATA 



ON STATEMENT OUT OF RANGE 



Meaning 

In-core array size is too large. 

An attempt was made to use a virtual 
array before opening the correspond- 
ing disk file. 

Attempt was made to open a file on 
an I/O channel outside the range of 
the integer numbers 1 to 12. 

Attempt to input a line longer than 
255 characters (which includes any 
line terminator) . Buffer overflows. 

Floating point overflow or under- 
flow. If no transfer is made to 
an error handling routine, a is 
returned as the floating point 
value, (C) 

Acceptable arguments are within the 
approximate range -89<arg<+88. The 
value returned is zero. (C) 



Attempt to use a number as an in- 
teger when that number is outside 
the allowable integer range. If 
no transfer is made to an error 
handling routine, a is returned 
as the integer value. (C) 

Improperly formed input or value. 
For example, "1..2" is an improp- 
erly formed number. 

Negative or zero argument to log 
function. Value returned is the 
argument as passed to the function. 
(C) 

Attempt to take square root of a 
number less than zero. The value 
returned is the square root of the 
absolute value of the argument. (C) 

Attempt to reference an array ele- 
ment beyond the number of elements 
created for the array when it was 
dimensioned. 

Attempt to invert a singular or 
nearly singular matrix. 

The DATA list was exhausted and a 
READ requested additional data. 

The index value in an ON-GOTO or 
ON-GOSUB statement is less than one 
or greater than the number of line 
numbers in the list. 
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ERR 



Message Printed 



59 NOT ENOUGH DATA IN RECORD 



60 INTEGER OVERFLOW, FOR LOOP 



61 DIVISION BY 



Meaning 

An INPUT statement did not find 
enough data in one line to satisfy 
all the specified variables. 

The integer index in a FOR loop 
attempted to go beyond 32766 or 
below -32766. 

Attempt by the user program to 
divide some quantity by zero. If 
no transfer is made to an error 
handler routine, a is returned 
as the result. (C) 



C.2 NON-RECOVERABLE ERRORS 

Message Printed 
ARGUMENTS DON'T MATCH 

BAD LINE NUMBER PAIR 

BAD NUMBER IN PRINT-USING 

CAN'T COMPILE STATEMENT 



Meaning 

Arguments in a function call do not 
match, in number or in type, the 
arguments defined for the function. 

Line numbers specified in a LIST or 
DELETE command were formatted incor- 
rectly. 

Format specified in the PRINT-USING 
string cannot be used to print one 
or more values . 



CAN'T CONTINUE 



CATASTROPHIC ERROR 



DATA TYPE ERROR 



DEF WITHOUT FNEND 



END OF STATEMENT NOT SEEN 



EXECUTE ONLY FILE 



Program was stopped or ended at a 
spot from which execution cannot be 
resumed. 

The user program data structures are 
destroyed. This normally indicates 
a BASIC-PLUS malfunction and, if re- 
producible, should be reported to DEC 
on a Software Performance Report form 
(SPR) 

Incorrect usage of floating-point, 
integer, or character string format 
variable or constant where some other 
data type was necessary. 

A second DEF statement was encoun- 
tered in the processing of a user 
function without an FNEND statement 
terminating the first user function 
definition. 

Statement contains too many elements 
to be processed correctly. 

Attempt was made to add, delete or 
list a statement in a compiled (.BAC) 
format file. 
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Message Printed 
EXPRESSION TOO COMPLICATED 



FIELD OVERFLOWS BUFFER 



FILE EXISTS-USE REPLACE 



FNEND WITHOUT DEF 



FNEND WITHOUT FUNCTION CALL 



FOR WITHOUT NEXT 



ILLEGAL CONDITIONAL CLAUSE 



ILLEGAL DEF NESTING 



ILLEGAL DUMMY VARIABLE 



ILLEGAL EXPRESSION 



ILLEGAL FIELD VARIABLE 



ILLEGAL FN REDEFINITION 



ILLEGAL FUNCTION NAME 



Meaning 

This error usually occurs when 
parentheses have been nested too 
deeply. The depth allowable is 
dependent on the individual expres- 
sion. 

Attempt to use FIELD to allocate 
more space than exists in the speci- 
fied buffer. 

A file of the name specified in a 
SAVE command already exists. In 
order to save the current program 
under the name specified, use the 
REPLACE command. 

An FNEND statement was encountered 
in the user program without a pre- 
vious DEF statement being seen. 

A FNEND statement was encountered 
in the user program without a pre- 
vious function call having been 
executed. Function has been placed 
incorrectly among executable state- 
ments or an extra FNEND statement 
has been found. 

A FOR statement was encountered in 
the user program without a corre- 
sponding NEXT statement to terminate 
the loop. 

Incorrectly formatted condition ex- 
pression. 

The range of one function definition 
crosses the range of another func- 
tion definition. 

One of the variables in the dummy 
variable list of a user-defined 
function is not a legal variable 
name. 

Double operators, missing operators, 
mismatched parentheses, or some 
similar error has been found in an 
expression. 

The FIELD variable specified is un- 
acceptable. 

Attempt was made to redefine a user 
function. 

Attempt was made to define a func- 
tion with a function name not sub- 
scribing to the established format. 
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Message Printed 
ILLEGAL IF STATEMENT 
ILLEGAL IN IMMEDIATE MODE 

ILLEGAL LINE NUMBER (S) 

ILLEGAL MAGTAPE () USAGE 
ILLEGAL MODE MIXING 

ILLEGAL STATEMENT 

ILLEGAL SYMBOL 

ILLEGAL VERB 

INCONSISTENT FUNCTION USAGE 



INCONSISTENT SUBSCRIPT USE 



K OF CORE USED 



LITERAL STRING NEEDED 



MATRIX DIMENSION ERROR 



MATRIX OR ARRAY WITHOUT DIM 



MAXIMUM CORE EXCEEDED 



MISSING SPECIAL FEATURE 



Meaning 

Incorrectly formatted IF statement. 

User issued a statement for execu- 
tion in immediate mode which can 
only be performed as part of a pro- 
gram. 

Line number reference outside the 
range l<rr<3276 7. 

Improper use of the MAGTAPE function. 

String and numeric operations cannot 
be mixed. 

Attempt was made to execute a state- 
ment that did not compile without 
errors. 

An unrecognizable character was en- 
countered. For example, a line con- 
sisting of a # character. 

The BASIC verb portion of the state- 
ment cannot be recognized. 

A function is being redefined in a 
manner inconsistent in the number or 
type of arguments with one or more 
calls to that function existing in 
the program. 

A subscripted variable is being used 
with a different number of dimensions 
from the number with which it was 
originally defined. 

Message printed by LENGTH command, 
preceded by the appropriate number 
describing the user program currently 
in core to the nearest IK. 

A variable name was used where a 
numeric or character string was 
necessary. 

Attempt was made to dimension a 
matrix to more than two dimensions, 
or an error was made in the syntax 
of a DIM statement. 

A matrix or array element was ref- 
erenced beyond the range of an 
implicitly dimensioned matrix. 

User program grew to be too large 
to run or compile in the area of 
core assigned to each user at the 
given installation. 

User program employs a BASIC-PLUS 
feature not present on the given 
installation. 
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Message Printed 



Meaning 



MODIFIER ERROR 



Attempt to use one of the statement 
modifiers (FOR, WHILE, UNTIL, IF, 
or UNLESS) incorrectly. 



NEXT WITHOUT FOR 



NO LOGINS 



NOT A RANDOM ACCESS DEVICE 



A NEXT statement was encountered in 
the user program without a previous 
FOR statement having been seen. 

Message printed if the system is 
full and cannot accept additional 
users or if further logins are dis- 
abled by the system manager. 

Attempt to perform random access I/O 
to a non-random access device. 



NOT ENOUGH AVAILABLE CORE 



The already compiled user program is 
too large to run in the area of core 
assigned to each user at the given 
installation. 



NUMBER IS DEEDED 



1 OR 2 DIMENSIONS ONLY 



A character string or variable name 
was used where a number was necessary. 

Attempt was made to dimension a matrix 
to more than two dimensions. 



ON STATEMENT NEEDS GOTO 



A statement beginning with ON does 
not contain a GOTO or GOSUB clause. 



PLEASE SAY HELLO 



PLEASE USE THE RUN COMMAND 



PRINT-USING BUFFER OVERFLOW 



User not logged into the system has 
typed something other than a legal, 
logged-out command to the system. 

A transfer of control (as in a GOTO, 
GOSUB or IF-GOTO statement) cannot 
be performed from immediate mode. 

Format specified contains a field too 
large to be manipulated by the PRINT- 
USING statement. 



PRINT-USING FORMAT ERROR 



PROGRAM LOST-SOHRY 



An error was made in the construction 
of the string used to supply the out- 
put format in a PRINT-USING statement. 

A fatal system error has occurred 
which caused the user program to be 
lost. 



REDIMENSIONED ARRAY 



RESUME AND NO ERROR 



Usage of an array or matrix within 
the user program has caused BASIC- 
PLUS to redimension the array im- 
plicitly. 

A RESUME statement was encountered 
where no error had occurred to cause 
a transfer into an error handling 
routine via the ON ERROR-GOTO state- 
ment. 
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Message Printed 



Meaning 



RETURN WITHOUT GOSUB 



RETURN statement encountered in the 
user program without a previous 
GOSUB statement having been executed. 



STATEMENT NOT FOUND 



STOP 



STRING IS NEEDED 



SYNTAX ERROR 



TEXT TRUNCATED 



TOO FEW ARGUMENTS 



TOO MANY ARGUMENTS 



UNDEFINED FUNCTION CALLED 



WHAT? 



WRONG MATH PACKAGE 



Reference is made within the program 
to a line number which is not within 
the program. 

STOP statement was executed. The 
user can usually continue program 
execution by typing CONT and the 
RETURN key. 

A number cr variable name was used 
where a character string was neces- 
sary. 

BASIC-PLUS statement was incorrectly 
formatted. 

No BASIC-PLUS statement can be more 
than 255 characters long. 

The function has been called with 
a number of arguments not equal to 
the number defined for the function. 

A user-defined function may have up 
to five arguments. 

BASIC-PLUS interpreted some state- 
ment component as a function call 
for which there is no defined func- 
tion {system or user) . 

Command or immediate mode statement 
entered to BASIC-PLUS could not be 
processed. Illegal verb or improper 
format error most likely. 

Program was compiled with an incom- 
patible version of RSTS. Program 
source must be recompiled. 



C.3 SYSTEM IDENTIFICATION MESSAGE 

ERR code is associated with the system installation name 
for use by the system programs. 



C-9 



APPENDIX D 
BASIC-PLUS CHARACTER SET 

D.l BASIC-PLUS CHARACTER SET 

User program statements are composed of individual characters. 
Allowable characters come from the following character set: 

A through Z 
through 9 
Space 
Tab 
and the following special symbols and keys: 

Key Use and Section in BASIC-PLUS Language Manual 

$ Used in specifying string variables (Section 5.1), 
or as the System Library file designator ( RSTS-11 
System User's Guide ) . 

% Used in specifying integer variables (Section 6.1). 

1 " Used to delimit string constants, i.e., text 
strings (Section 5.1). 

! Begins comment part of a line (Section 3.1). 

: Separates multiple statements on one line 
(Section 2.3.1) . 

# Denotes a device or file # name, or is used as an 

output format effector (Chapter 7 and Section 10.4). 

, Output format effector and list terminator 
(Section 3.3) . 

; Output format effector (Section 3.3). 

LINE When used at the end of a line, indicates that 
FEED the current statement is continued on the next 
line (Section 2.3.2). 

() Used to group arguments in an arithmetic ex- 
pression (Section 2.5). 

[ ] Used to group project-programmer number. 

< > Used to delimit file protection codes. 

+ - Arithmetic operators (Section 2.5.3). 
* / + 

= Replacement operator (Section 3.2). 

Logical equivalence operator (Section 2.5.4). 

< Logical "less than" operator (Section 2.5.4). 

Logical "greater than" operator (Section 2.5.4). 

Logical "approximately equal to" operator (Section 2.5. 4) 
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D.2 ASCII CHARACTER CODES 















Decimal 


ASCII 


RSTS 


Decimal 


ASCII 


RSTS 


Value 


Character 


Usage 


Value 


Character 


Usage 


64 


@ 




96 


v 




65 


A 




97 


a 




66 


B 




98 


b 




67 


C 




99 


c 




68 


D 




100 


d 




69 


E 




101 


e 




70 


F 




102 


f 




71 


G 




103 


g 




72 


H 




104 


h 




73 


I 




105 


i 




74 


J 




106 


J 




75 


K 




107 


k 




76 


L 




108 


1 




77 


M 




109 


m 




78 


N 




110 


n 




79 







111 


o 




80 


P 




112 


P 




81 


Q 




113 


q 




82 


R 




114 


r 




83 


S 




115 


s 




84 


T 




116 


t 




85 


U 




117 


u 




86 


V 




118 


V 




87 


w 




119 


w 




88 


X 




120 


X 




89 


Y 




121 


Y 




90 


Z 




122 


z 




91 


[ 




123 


{ 




92 


\ 


Backslash 


124 


1 


Vertical Line 


93 


] 




125 


} 




94 


or + 




126 


~ 


Tilde 


95 


or *■ 




127 


DEL 


RUBOUT 



D.3 CARD CODES 

The RSTS card driver can be configured for one of three different 
punched card codes. These are: DEC029 codes, DEC026 codes and 1401 

(EBCDIC) codes. The RSTS-11 DEC029 and DEC026 codes are the same as 
the DOS-11 card codes. The particular set of codes used on the system 
is determined by the system manager. In all cases, the end-of-file 

(EOF) card must contain a 12-11-0-1 punch or a 12-11-0-1-6-7-8-9 punch 

in column 0, 
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CHARACTER ASCII 



m. 



DEC029 



DEC026 



1401 



D 
I 



{ 

} 

SPACE 



/ 


1 
2 
3 
4 
5 
6 
7 
8 
9 



123 
125 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 



8 7 



8 3 



12 

11 
NONE 
12 
8 7 
8 3 
11 
8 4 
12 

8 5 

12 8 
11 8 

11 8 

12 8 
8 3 
11 

12 8 

1 



1 

2 

3 

4 

5 

6 

7 

8 

9 

8 2 

11 8 i 

12 8 • 
8 6 

8 6 
8 7 



12 

11 
NONE 

12 8 7 
8 5 
8 6 
11 8 3 
8 7 

11 8 7 
8 6 

8 4 

12 8 4 

11 8 4 
12 

8 3 
11 

12 8 3 
1 


1 
2 
3 
4 
5 
6 
7 
8 
9 

11 8 2 
8 2 

12 8 6 
8 3 

11 8 6 

12 8 2 



8 4 

5 
3 



UNUSED 
UNUSED 
NONE 
11 
8 2 
8 3 

11 8 3 
8 4 
12 

12 8 4 
8 7 

8 7 

11 

8 

8 

11 

12 8 

1 



1 

2 

3 

4 

5 

6 

7 

8 

9 

8 5 

11 8 

12 8 

11 8 
8 6 

12 



CHARACTER 



asci: 



10 



DEC029 DEC026 



1401 



A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

O 

P 

Q 

R 

S 

T 

U 

V 

W 

X 

Y 

Z 

[ 

\ 

] 

+ or 

«- or 



64 


8 4 


8 4 


65 


12 


1 


12 1 


66 


12 


2 


12 2 


67 


12 


3 


12 3 


68 


12 


4 


12 4 


69 


12 


5 


12 5 


70 


12 


6 


12 6 


71 


12 


7 


12 7 


72 


12 


8 


12 8 


73 


12 


9 


12 9 


74 


11 


1 


11 1 


75 


11 


2 


11 2 


76 


11 


3 


11 3 


77 


11 


4 


11 4 


78 


11 


5 


11 5 


79 


11 


6 


11 6 


80 


11 


7 


11 7 


81 


11 


8 


11 8 


82 


11 


9 


11 9 


83 


2 




2 


84 


3 




3 


85 


4 




4 


86 


5 




5 


87 


6 




6 


88 


7 




7 


89 


8 




8 


90 


9 




9 


91 


12 


8 2 


11 8 


92 


8 


2 


8 7 


93 


11 


8 2 


12 8 


94 


11 


8 7 


8 5 


95 


8 


5 


8 2 



8 4 
12 1 



12 

12 

12 

12 

12 

12 

12 8 

12 9 

11 

11 

11 

11 

11 

11 6 

11 7 

11 8 

11 9 





1 
2 
3 
4 
5 










2 

3 

4 

5 

6 

7 
8 
9 

12 8 5 
8 6 

11 8 5 
unused 

12 8 7 



EOF is 12-11-0-1 punch or a 12-11-0-1-6-7-8-9 punch. 



D.4 RADIX-50 CHARACTER SET 

Radix- 50 

Character ASCII Octal Equivalent Equivalent 

space 40 

A-Z 101 - 132 1 - 32 

$ 44 33 

56 34 

unused 35 

0-9 60 - 71 36 - 47 



The maximum Radix-50 value is, thus, 

47*50 2 + 47*50 + 47 = 174777 

The following table provides a convenient means of translating 
between the ASCII character set and its Radix-50 equivalents. For 
example, given the ASCII string X2B, the Radix-50 equivalent is 
(arithmetic is performed in octal) : 

X = 113000 
2 = 002400 
B = 000002 

X2B = 115402 
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Radix-50 Character/Position Table 



Single Char. 






or 


Second 


Third 


First Char. 


Character 


Character 


A 003100 


A 000050 


A 000001 


B 006200 


B 000120 


B 000002 


c 0H300 


C 000170 


C 000003 


D 014400 


D 000240 


D 000004 


E 017500 


E 000310 


E 000005 


F 6226164 


F 000360 


F 000006 


g 025700 


G 000430 


G 000007 


h 031000 


H 000500 


H 000010 


I 034100 


I 000550 


I 000011 


J 16372016 


J 000620 


J 000012 


K 042300 


K 000670 


K 000013 


L 045400 


L 000740 


L 000014 


M 050500 


M 001010 


M 000015 


N 053600 


N 001060 


N 000016 


056700 


001130 


000017 


P 062000 


P 001200 


P 000020 


Q 065100 


Q 001250 


Q 000021 


R 070200 


R 001320 


R 000022 


S 073300 


S 001370 


S 000023 


T 076400 


T 001440 


T 000024 


U 101500 


U 001510 


U 000025 


V 104600 


V 001560 


V 000026 


W 107700 


W 001630 


W 000027 


X 113000 


X 001700 


X 000030 


Y 116100 


Y 001750 


Y 000031 


Z 121200 


Z 002020 


Z 000032 


$ 124300 


$ 002070 


$ 000033 


12 7400 


002140 


000034 


unused 132500 


unused 002210 


unused 000035 


135600 


002260 


000036 


1 140700 


1 002330 


1 000037 


2 144000 


2 002400 


2 000040 


3 147100 


3 002450 


3 000041 


4 152200 


4 002520 


4 000042 


5 155300 


5 002570 


5 000043 


6 160400 


6 002640 


6 000044 


7 163500 


7 002710 


7 000045 


8 166600 


8 002760 


8 000046 


9 171700 


9 003030 


9 000047 
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INDEX 



Account numbers, 2-1 
ALT MODE key, 3-1 
ASR-33 terminal, 3-1 
ASSIGN, 2-25 
Assigned devices, 1 -4 

.BAC and .BAS, see File extensions 
BYE, 2-3, 2-26, 4-5 

Card reader, 2-14, 5-6 
CAT, 2-22, 4-16 
CATALOG, 2-22, 4-16 
CHAIN, 2-15 
Change filename, 4-13 
Change protection code, 4-13 
Character set, D-l 
COMPILE, 2-6, 2-15 
CONT, 2-12 
CTRL/C, 2-12, 3-2, 3-3 
CTRL/I, 3-3 
CTRL/O, 3-3 
CTRL/U, 2-8, 3-2 
CTRL/Z, 3-4 

Data set, 1-5, 4-2 

DEASSIGN, 2-26 

Debugging, 2-12 

DECtape, 5-11 

DELETE, 2-7, 2-10, 2-12 

Device specifications, 2-25 

Directory, 

disk, 2-22 

list, 4-16 

zero, 4-16 
Dollar sign, 2-20, 2-23, 3-1 

Editing, 2-7, 2-8 
Editing phase(mode), 2-8 
Echo, 2-23, 2-24 
Error Messages, C-l 
ESCAPE key, 3-1 
Extensions, 2-19, 2-20 

.BAC, 2-16, 2-21 

.BAS, 2-17, 2-19, 2-21, 2-22 

File deletion, 4-15 
File transfers, 4-13 
File merges, 4-13 
Files, 

closing, 2-15 

extensions, 2-16, 2-17, 2-19, 2-21, 2-22 

protection, 1-5 
Functions, A-2 



HELLO, 2-1, 2-6, 4-2 

HELP, 2-6, 4-2 

High-speed reader/punch, 5-4 

Input of new programs, 2-7 
Interactive programs, 1-2 

KEY, 2-24, 3-1 

LENGTH, 2-22 

LINE FEED key, 3-1 

Line printer, 5-7 

LIST, 2-17, 2-7, 2-9 

List device directory, 4-16 

LISTNH, 2-10 

Logged out system commands, 2-5 

LOGIN, 2-1, 4-2 

LOGOUT, 4-5 

Magtape, 5-14 
Modem, 1-5 
MONEY, 4-25 
Multiprogramming, 1-2 

NAME-AS, 2-19 
NEW, 2-6 
NONAME, 2-7, 2-18 

OLD, 2-7, 2-13, 2-18, 2-19 
Operators, A-l 

Paper tape reader, 2-14 

Passwords, 2-1 

PIP, 4-11 

Project-programmer numbers, 2-1 

Protection codes, 2-17, 2-19 

Quantum, 1-2 
QUOLST, 4-23 

Records, 1-4 

Remote users, 1-5, 4-2 

RENAME, 2-11 

REPLACE, 2-21 

Resources, system, 1-4 

RETURN key, 2-8, 2-11, 2-24, 3-1 

RUBOUT key, 2-24, 2-8, 3-1, 3-2 

RUN, 2-19, 2-13 

RUNNH, 2-13 

SAVE, 2-6, 2-7, 2-11, 2-21, 2-17 
Scheduling, 1-3 
Segmenting, 2-15 
SET, 2-6, 4-2, 4-19 
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Slash character, 2-3 
Spaces, 2-20, 4-11 
Statement summary, A-5 
STOP statement, 2-12 
SYS, 2-6, 4-2, 4-7 
SYSTAT, 4-7 
System Library, 2-20 
System status reports, 2-22 

TAB character, 3-3, 4-11 
TAPE, 2-23, 3-1 
Teletype, 5-1 
Temporary files, 2-5 
Time quantum, 1-2 
Timesharing, 1-1 
TTYSET, 4-19 

UNSAVE, 2-21 

Variables, A-l 

Zero device directory, 4-16 
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READER'S COMMENTS 



Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness 
of its publications. To do this effectively we need user feedback — your critical evaluation of 
this manual . 

Please comment on this manual's completeness, accuracy, organization, usability and read- 
ability. 



Did you find errors in this manual? If so, specify by page. 



How can this manual be improved? 



Other comments? 



Please state your position. Date: 

Name: Organization: 



Street: Department: 



City: State: Zip or Country 
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